mac-cleanup

Mac Disk Cleanup

Clean up safe Mac cache locations, report how much space was freed, and flag any oversized folders worth reviewing manually.

Use this skill when the user says things like: "clean my Mac", "free up disk space", "clear cache", "my Mac is slow", "running out of space", "Mac cleanup", "disk cleanup", "tidy up my Mac", "ניקוי מק", "פנה מקום", "המק שלי מלא", "nettoyage Mac", "limpiar Mac", or any similar request about freeing storage on a Mac.

Also runs automatically when triggered as a scheduled task.

---

How to run this skill

Work through each phase in order. Communicate with the user in whatever language they used.

Environment note: This skill works in both Claude Code (native Bash tool) and Cowork (Desktop Commander). Use whichever shell execution method is available in your environment to run the bash commands below.

---

Phase 1 — Measure before

Run these two commands and record the results:

df -h / | tail -1

du -sh \
  ~/Library/Caches/Google/ \
  ~/Library/Caches/pip/ \
  ~/Library/Caches/node-gyp/ \
  ~/Library/Caches/org.swift.swiftpm/ \
  ~/.gradle/caches/ \
  ~/Library/Caches/Homebrew/ \
  2>/dev/null

Note the "Avail" column from df as before_avail and record each cache size.

---

Phase 2 — Clean

Run each command. If a command fails (permission denied, not found), note it and continue — do not abort.

# Google Chrome disk cache (passwords/history/bookmarks are in Application Support, NOT here — safe to delete)
rm -rf ~/Library/Caches/Google/ 2>/dev/null; true

# npm cache
npm cache clean --force 2>/dev/null; true

# Yarn cache
yarn cache clean 2>/dev/null; true

# pip cache
rm -rf ~/Library/Caches/pip/ 2>/dev/null; true

# Swift Package Manager cache (auto-regenerated on next build)
rm -rf ~/Library/Caches/org.swift.swiftpm/ 2>/dev/null; true

# Gradle caches (auto-regenerated on next build)
rm -rf ~/.gradle/caches/ 2>/dev/null; true