disk-cleanup
Survey and clean macOS caches to reclaim disk space safely.
Scan and clean macOS system caches, package manager caches, and app data to reclaim disk space. Surveys ~/Library/Caches, ~/.cache, Docker, npm/pip/uv/pnpm, Homebrew, browser caches, app updater caches, Claude Desktop, Xcode DerivedData, Playwright browsers, system logs, and ML model caches.
What it does
Surveys every major cache location on macOS — system caches, package managers, browser data, Docker images, app updater artifacts, ML model stores — and presents a size-sorted inventory table. Then cleans selected items using trash (never rm), so everything is recoverable from Trash until you explicitly empty it.
Key features
- Four preset levels —
safe(caches, logs, updaters),docker(adds Docker prune),full(adds ML models), orpick(choose item by item) - Discovery sweep — catches unlisted caches over 100 MB that aren’t in the hardcoded list, so the skill stays useful as you install new tools
- Safe by default — uses macOS
trashcommand, neverrm. Files go to Trash first - Dry-run mode — survey and report sizes without deleting anything
- Before/after report — shows disk usage change and warns about Trash needing to be emptied
- Skip list — exclude specific locations (e.g.,
skip: docker, huggingface) when you need those caches intact
When to use
When running low on macOS disk space, getting “disk almost full” warnings, or wanting to audit what’s consuming storage across system caches, package managers, and app data.