macOS Disk Cleanup Advisor
Safely analyzes macOS disk usage and produces a cleanup report that explains the real cost of deleting each item.
UtilitiesIntermediate★ 1,323⑂ 212AI score 9/10Last updated: Aug 8, 2026
What it does
- Runs Mole (
mo analyze) inside tmux plus bundled Python scripts to scan caches, logs, app remnants, large files, and dev tooling (Docker, npm, Homebrew, pip). - Classifies every finding as 🟢 safe / 🟡 trade-off / 🔴 do not delete, always with an "impact if deleted" column.
- Bans all
docker ... prunecommands; requires per-object inspection and deletion by explicit image/volume name. - Never auto-deletes: Claude hands you the commands, then verifies with
df -hbefore/after.
Who it's for
- Mac users out of disk space with no idea what's eating it.
- Developers sitting on tens of GB of Docker images and volumes.
- Anyone burned by wiping useful caches (the skill factors in slow networks and redownload cost).
Examples
- "My Mac is out of space" → quick diagnosis and a report like "45 GB in ~/Library/Caches, but keep the npm cache — 2 hr redownload".
- "Clean up my dev environment" →
scripts/analyze_dev_env.pylists Docker volumes per project before proposing precisedocker volume rmcommands. - "What's using all my space?" → top 20 files over 100 MB grouped into videos, datasets, archives, and disk images.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/macos-cleaner/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the macos-cleaner folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/macos-cleaner/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/macos-cleaner ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open Terminal.
- Clone the repo:
git clone https://github.com/daymade/claude-code-skills.git - Install the skill:
mkdir -p ~/.claude/skills && cp -r claude-code-skills/macos-cleaner ~/.claude/skills/ - Install prerequisites:
brew install tw93/tap/mole(andbrew install tmuxif needed). - Restart Claude Code and ask something like "help me free up disk space on my Mac".
- Review every suggested command before running it yourself, and create a Time Machine backup before clearing more than 10 GB.
View source on GitHub ↗License: MIT