Andrew Yim
8d5cfb69fd
Restructured 92-mac-optimizer from a CLAUDE.md-based skill into a full Claude Code plugin with .claude-plugin/plugin.json, 6 slash commands (/mac-doctor, /mac-packages, /mac-environment, /mac-security, /mac-cleanup, /mac-resources), and auto-trigger SKILL.md. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2.9 KiB
2.9 KiB
Cleanup Targets Reference
Risk Ratings
| Risk | Meaning |
|---|---|
| Safe | Can be deleted without consequence; regenerated automatically |
| Moderate | Review before deleting; may lose useful data |
| Risky | May break applications; requires careful inspection |
| Info only | Report size but do not offer deletion |
Target Details
User Logs (Safe)
- Path:
~/Library/Logs/ - Cleanup target:
user-logs - Notes: Application crash reports and debug logs. Regenerated as needed.
System Logs (Moderate, requires sudo)
- Path:
/var/log/ - Cleanup target: not available via cleanup_execute.sh (requires sudo)
- Notes: System-level logs. Only clean old/rotated files. Active logs should not be deleted.
User Caches (Safe, per-app)
- Path:
~/Library/Caches/ - Cleanup target:
user-caches - Notes: App caches regenerated on next use. Some apps may need to re-download data. Browser caches can be large.
Homebrew Cache (Safe)
- Path:
$(brew --cache)(typically~/Library/Caches/Homebrew/) - Cleanup target:
brew-cache - Notes: Downloaded bottles and source archives.
brew cleanuphandles this properly.
npm Cache (Safe)
- Path:
~/.npm/_cacache/ - Cleanup target:
npm-cache - Notes: Package download cache.
npm cache clean --forceis the proper way to clear.
pip Cache (Safe)
- Path:
~/Library/Caches/pip/ - Cleanup target:
pip-cache - Notes: Downloaded wheel/sdist cache.
pip cache purgeis the proper way to clear.
Xcode DerivedData (Safe)
- Path:
~/Library/Developer/Xcode/DerivedData/ - Cleanup target:
xcode-derived - Notes: Build artifacts and indexes. Rebuilt on next Xcode build. Can grow very large.
Xcode Archives (Moderate)
- Path:
~/Library/Developer/Xcode/Archives/ - Cleanup target:
xcode-archives - Notes: App Store submission archives. May be needed for symbolication of crash reports. Review before deleting.
iOS DeviceSupport (Safe)
- Path:
~/Library/Developer/Xcode/iOS DeviceSupport/ - Cleanup target:
ios-support - Notes: Debug symbols for connected iOS devices. Re-downloaded when device connects again.
Docker (Moderate)
- Cleanup target:
docker - Notes: Uses
docker system prune -f. Removes stopped containers, unused networks, dangling images. Does NOT remove named volumes. Never delete Docker's filesystem directly.
Trash (Safe)
- Path:
~/.Trash/ - Cleanup target:
trash - Notes: Items in Trash. User has already "deleted" these.
Old Downloads (Info only)
- Path:
~/Downloads/(files >90 days old) - Notes: Report only. User should review manually. Never auto-delete downloads.
Application Support Remnants (Risky)
- Path:
~/Library/Application Support/orphaned directories - Notes: Report only. Directories from uninstalled apps. Difficult to determine automatically which are truly orphaned. Manual review required.