mac-cleanuplisted

Reclaim disk space and RAM on Apple Silicon macOS, safely — for developers AND creative pros. Use when the user is low on disk, asks what is eating space or memory, wants to clear caches for developer tools (gradle, npm, pnpm, yarn, brew, uv, pip, cargo, go, CocoaPods, Xcode, Android NDK/emulators, Docker/colima) OR creative apps (Final Cut, Premiere, After Effects, DaVinci Resolve, Lightroom, Photoshop, Capture One, Logic, Ableton, Pro Tools, Blender, Houdini, Cinema 4D, Unreal, browsers), or wants to find and stop background dev servers / analyze why Chrome or an app is using so much RAM. Always measures first and asks before deleting.
sai-na/claude-mac-cleanup · ★ 0 · DevOps & Infrastructure · score 73

Install: claude install-skill sai-na/claude-mac-cleanup

# mac-cleanup Reclaim disk and RAM on **Apple Silicon macOS** without breaking anything. This skill is **scan-first and confirm-before-delete**: it measures, shows the user what is reclaimable and what each item costs to regenerate, and only deletes after an explicit yes. The bundled scripts live next to this file; invoke them with `${CLAUDE_SKILL_DIR}`. ## Safety contract — follow every time 1. **Measure before you touch anything.** Never delete before showing the user a size. 2. **On Apple Silicon, read the Data volume**, never plain `/`. Use `df -h /System/Volumes/Data` (`/` is a sealed read-only system snapshot and understates usage badly). 3. **Three tiers** (full table in `references/cleanup-targets.md`): - **SAFE** — regenerates automatically, cheap. Fine to batch after one confirmation. - **CAUTION** — regenerates but a big/slow re-download or loses state. Confirm each, state the cost. - **NEVER** — refuse and explain. Xcode **Archives/dSYMs**, provisioning profiles, iOS device backups, Keychain, `~/.ssh`/`~/.gnupg`/`~/.aws`, **iCloud** (`~/Library/Mobile Documents`), and **Hugging Face models** (`~/.cache/huggingface` — deliberate multi-GB downloads, not junk). 4. **Prefer a tool's own cache-clean subcommand** over `rm` (npm/brew/uv/pip/pod…). Reserve raw deletion for dirs with no cleaner, and only via the guarded `clean.sh`. 5. **Deletions are not pre-approved.** `allowed-tools` only pre-clears read-only commands, so every actual dele