macOS Disk Cleanup

Recover disk space on macOS by cleaning caches, dev tool artifacts, stale dependencies, logs, and other reclaimable storage. Developer-focused — knows where the real space hogs hide on a dev machine.

Core Philosophy

1. Analyze before deleting. Always scan first. Show the user what's consuming space and how much can be reclaimed before touching anything.
2. Risk-aware cleanup. Categorize targets by risk (safe → low → moderate → high). Clean safe items freely, require confirmation for everything else.
3. Use built-in cleanup commands. Prefer brew cleanup, npm cache clean, xcrun simctl delete unavailable over raw rm -rf. Tools know their own cleanup semantics better than we do.
4. Never touch user data. Documents, Desktop, Pictures, credentials, SSH keys, keychains, git repos — hands off. Always.
5. Report results. After cleanup, show before/after disk space comparison.