3.9 KiB
3.9 KiB
description
| description |
|---|
| Clean up old archives, logs, and temporary files to free disk space |
Steering Context Generator - Clean
Remove old archives and temporary files to free up disk space.
Quick Start
/steering-clean
This will:
- Archive current context (backup)
- Remove archives older than 7 days
- Clean logs older than 30 days
- Remove cache files
- Delete temporary files
What Gets Cleaned
| Item | Location | Retention | Impact |
|---|---|---|---|
| Old archives | .claude/memory/archives/ |
7 days | Can regenerate |
| Old logs | .claude/logs/ |
30 days | Lost history |
| Cache files | .claude/steering/v2.0/cache/ |
All | Rebuilt on next use |
| Temp files | .claude/memory/**/*.tmp |
All | Safe to delete |
Implementation
bash scripts/cleanup.sh
Expected Output
🧹 Cleaning Steering Context Generator artifacts...
Artifacts to clean:
Archives: 450 MB
Logs: 23 MB
Cache: 12 MB
Continue? (y/N) y
Archiving current context to .claude/memory/archives/backup_20251102_120000...
✓ Archived 9 files
Cleaning old archives (>7 days)...
✓ Removed 3 old archives (380 MB freed)
Cleaning old logs (>30 days)...
✓ Removed 145 log files (18 MB freed)
Cleaning cache...
✓ Cleared cache (12 MB freed)
Cleaning temporary files...
✓ Removed 23 temp files (2 MB freed)
Cleanup complete!
Current usage:
Archives: 70 MB
Logs: 5 MB
Total: 250 MB
Total freed: 412 MB
Safety Features
Automatic Backup: Before cleaning, current context is archived:
.claude/memory/archives/backup_YYYYMMDD_HHMMSS/
├── ARCHITECTURE.md
├── AI_CONTEXT.md
├── CODEBASE_GUIDE.md
└── ...
Confirmation Prompt: Interactive mode asks for confirmation before deleting.
Dry Run: See what would be cleaned without actually deleting:
bash scripts/cleanup.sh --dry-run
Cleanup Options
Aggressive Cleanup
Remove all archives (not recommended):
# Manual aggressive cleanup
rm -rf .claude/memory/archives/*
rm -rf .claude/logs/*
Selective Cleanup
Clean specific areas only:
Archives only:
find .claude/memory/archives -type d -mtime +7 -exec rm -rf {} +
Logs only:
find .claude/logs -type f -mtime +30 -delete
Cache only:
rm -rf .claude/steering/v2.0/cache/*
Custom Retention
Edit scripts/cleanup.sh to change retention periods:
# Archives: Change from 7 to 30 days
find .claude/memory/archives -type d -mtime +30 -exec rm -rf {} +
# Logs: Change from 30 to 90 days
find .claude/logs -type f -mtime +90 -delete
When to Clean
Regular Maintenance:
- Weekly: For active projects
- Monthly: For stable projects
- Before: Major releases
- When: Low disk space warnings
Signs You Need Cleaning:
- ⚠ Archive size > 500 MB
- ⚠ Total .claude/ size > 2 GB
- ⚠ Disk space warnings
- ⚠ Slow operations
Recovering Cleaned Data
Recent Backup:
# List available backups
ls -lh .claude/memory/archives/backup_*/
# Restore latest backup
LATEST=$(ls -t .claude/memory/archives/backup_* | head -1)
cp -r $LATEST/*.md .claude/steering/
From Git: If context files are committed:
git log -- .claude/steering/
git checkout HEAD~1 -- .claude/steering/
Regenerate: If no backups available:
/steering-generate
Troubleshooting
"Permission denied" errors
chmod +x scripts/cleanup.sh
Cleanup doesn't free space
Check hidden or locked files:
lsof | grep .claude
Accidentally deleted current context
# Restore from latest backup
LATEST=$(ls -t .claude/memory/archives/backup_* | head -1)
cp -r $LATEST/*.md .claude/steering/
Free up space: Run /steering-clean regularly!