cleanup
Skill2 starsChanged 10 days agoMITView on GitHub
Free disk space, RAM, and CPU on a Mac used for development: safe cache cleanup, iOS/Xcode build and simulator cleanup, AI-agent worktree sweep that rescues unmerged work, memory-hog and runaway triage (Gradle daemons, idle Docker/Colima VM, leaked ChatGPT Codex helpers), and zombie/orphan process cleanup. Use when the user says cleanup, disk full, storage full, low space, system slow or lagging, RAM/CPU cleanup, kill zombie processes, or asks to free space or speed up the machine.
- Deletes or force-pushes
- Installs packages
78 other projects use a version of this.
Adopted by
Most recently taken up by
- travissmithv1/claude-skillstheir own version, first seen Nov 16, 2026
- leejianrong/claude-skillstheir own version, first seen Nov 16, 2026
- ronedgecomb/anythingtheir own version, first seen Nov 16, 2026
- gregwebs/skills-sdlctheir own version, first seen Nov 15, 2026
- ekirton/Pouletheir own version, first seen Nov 15, 2026
- willcoliveira/mac-cleanup-agenttheir own version, first seen Nov 15, 2026
Used with
Projects with it also use chips, react-query-best-practices and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
udecodeSkillchips
Run the project's suggested-task ledger, the chips. /chips alone brings this session's open tasks up to date: it applies what the ledger helper says, settles stale and split tasks, cards what can start and reports the board, and /chips all also takes the ship-list tasks and the ones no live session owns, and merges duplicate tasks across the board. Use for /chips, /chips offer, start or drop, \"what chips are open\", \"suggest a task for X\", \"update the chips\", \"clean up the chips\", \"which chips are stale\", \"is this chip still worth doing\", \"merge duplicate chips\", at the last hand-back of a run that offered a task, and whenever pstack would file a tracked issue, a follow-up, a reflect Backlog item or an out-of-band PR.
Also in 3 projects that use this
bibektimilsina00Skillreact-query-best-practices
Audit and fix React Query usage in apps/web — enforce query key factories, signal forwarding, staleTime, and proper mutation patterns. Use when reviewing or fixing server-state code.
Also in 3 projects that use this
bibektimilsina00Skillyou-might-not-need-a-callback
Analyze and fix useCallback anti-patterns in your code
Also in 3 projects that use this
Scylla23Skillredo
Re-run the last routed task one model tier up (haiku → sonnet → opus → fable). User-invoked escalation when the previous result missed. Pass --dry-run to preview without running.
Also in 3 projects that use this
Aetheria-Labs1Skillplan-page
Plan one storefront page from strategy through final copy, section order, proof, offers, template direction, responsive layout, and production asset requirements. Stops at an approved execution-ready specification.
Also in 3 projects that use this
SocialKit-APISkillvideo-transcripts
Extract transcripts from social videos through SocialKit across YouTube, TikTok, Instagram, Facebook, X/Twitter, LinkedIn, and direct video file URLs. Use when the user asks to transcribe, get captions or subtitles, pull the spoken text, or read what a video says, including one video or many at once. Returns full text plus timestamped segments. Not for posting, private accounts, or unrelated website scraping.
Also in 3 projects that use this
- +3 more from bibektimilsina00
Other versions78 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 78
- simstudioai/sim★ 30ksame name
- pipecat-ai/pipecat★ 17ksame name
- udecode/plate★ 17ksame name
- civitai/civitai★ 7.3ksame name
- mampfes/hacs_waste_collection_schedule★ 2.3ksame name
- trycompai/comp★ 2.1ksame name
- udecode/dotai★ 1.2ksame name
- LedgerHQ/ledger-live★ 627same name
- ericboy0224/learn-docker-and-k8s★ 472same name
- udecode/better-convex★ 452same name
68 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
Show its rules and text
We split this skill into the rules it gives an agent
20 rules. 0 are common, 5 are distinctive, and 15 are very specific to this project.
0
Common
Most of the 66 edited versions we read keep these.
5
Distinctive
This author's own choices. Worth a look.
15
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
By hand: read the phases, save the scripts, run them yourself.
- Very specific: line 25
Swap lives on your boot disk: When free space drops by many GB within hours and you deleted nothing, the cause is memory pressure (swap …
- Distinctive: line 47
If so, don't clear build caches, don't stop its daemon, and don't restart the machine.
- Very specific: line 48
If the machine is too loaded for scripts to finish, take one ps snapshot to a file and analyze that instead of running many commands.
- Very specific: line 53
Run scripts/disk-batch.sh.
- Very specific: line 85
Run scripts/extras-clean.sh [code-folder] (report only), show the totals, ask once, then scripts/extras-clean.sh --apply.
- Very specific: line 110
Never select VM or container disks (~/.colima, ~/.lima, Docker, UTM, Parallels), even when they show up as the biggest items.
- Very specific: line 112
If files go missing, check ~/Library/Logs/MacClean/operations.log.
- Very specific: line 113
Check a VM after any cleaner run: lsof -p <VM pid> +L1 showing link count 0 on a disk file means it is already deleted.
- Very specific: line 133
Keep the commits reachable: git branch rescue/<name> HEAD
- Very specific: line 138
Test runs can leave a full build per run under <worktree>/test-results/, and agents copy whole source trees into /private/tmp/<project>-*.
- Very specific: line 144
Run scripts/process-triage.sh (report only), then act per finding:
- Very specific: line 168
Stale project dependencies: delete node_modules / .venv / ios/Pods only in projects idle 14+ days (no commits, no edits, no running process …
- Very specific: line 171
Docker images: remove only images no container uses (list them explicitly), then colima ssh -- sudo fstrim -a.
- Distinctive: line 175
Restart: only with no build running.
- Very specific: line 179
Never hard-delete user data: it goes to ~/.Trash, and the user empties it.
- Very specific: line 180
Never rm Gradle/browser caches for the user: print the command and let them run it.
- Distinctive: line 181
Never delete Xcode Archives, simulator app data, or iPhone backups without the user's explicit OK.
- Very specific: line 182
Never delete project node_modules/.venv, Downloads, or Documents except as the deep option above.
- Distinctive: line 183
Never kill in-flight builds, processes inside LIVE worktrees, or user-facing apps.
“Common” is measured: kept by at least 6 in 10 of the 66 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Mac Dev-Machine Cleanup
A safe, repeatable routine for freeing storage and RAM on a macOS developer machine (Apple Silicon or Intel), including iOS/Xcode setups. It works two ways:
- As a Claude Code skill:
git clone https://github.com/dipaksavaliya/mac-dev-cleanup ~/.claude/skills/cleanup, then type/cleanup. (Or save just this file as~/.claude/skills/cleanup/SKILL.md; on first use the agent saves the six scripts at the bottom intoscripts/next to it.) - By hand: read the phases, save the scripts, run them yourself.
The guiding rule: only remove things that rebuild themselves (package caches, build output, idle helper processes). Anything that could be someone's work goes to the Trash or gets rescued first.
Things that will surprise you on macOS
dulies;dftells the truth. APFS clones files, soducounts shared blocks twice. Measure every gain as the change indf -h /System/Volumes/Databefore vs after.- Swap lives on your boot disk. When free space drops by many GB within hours and you
deleted nothing, the cause is memory pressure (swap files are 1 GB each in
/System/Volumes/VM). Fix RAM first (Phase 3). Only a restart fully returns swap. - Load average lags. Right after a reboot Spotlight reindexing inflates it. Trust the
runnable process count (
ps -Ao stat | grep -c '^R') instead. - Activity Monitor's RSS undercounts. Swapped-out memory doesn't show in RSS; the
JetsamEvent reports in
/Library/Logs/DiagnosticReports/name the real hog even after it exits. - Cache cleans can free less than they report. A tool may say "removed 9 GiB" while
dfmoves 0.2 GB because project virtualenvs cloned those files.
Phase 0: Situate (always do this first)
df -h /System/Volumes/Data | tail -1 # free space
sysctl vm.swapusage # swap in use
ls /System/Volumes/VM | grep -c swapfile # swap files on disk
uptime- Is a build running? (Gradle, Xcode, Flutter,
next build; the triage script lists them.) If so, don't clear build caches, don't stop its daemon, and don't restart the machine. - If the machine is too loaded for scripts to finish, take one
pssnapshot to a file and analyze that instead of running many commands.
Phase 1: Disk caches (safe, run without asking)
Run scripts/disk-batch.sh. It cleans re-downloadable caches only:
uv (prune), npm, pnpm (prune), bun, pip, Homebrew, Docker build cache, and trims the Colima VM disk
(fstrim, which deletes nothing and returns freed VM blocks to macOS, often 1–3 GB).
It then prints (never runs) the big caches you should clear yourself, because a running IDE/browser may be using them: Gradle caches and Chrome's cache.
uv cache clean (full, not prune) only on a "deep" request. Long-running uvx servers hold
its lock; killing them first (pkill -f 'uv tool uvx') works but stops those MCP servers until
their apps restart.
Phase 1b: iOS / Xcode (when Xcode is installed)
Xcode is often the single biggest disk user on a Mac (tens of GB). Run scripts/ios-clean.sh
(report only), show the user the totals, ask once, then scripts/ios-clean.sh --apply.
| Tier | Item | Notes |
SAFE (--apply) | ~/Library/Developer/Xcode/DerivedData | Build products + index. Next build is a full rebuild. Skipped while Xcode is open or a build runs |
| SAFE | Xcode caches, SwiftUI preview simulators | Skipped while Xcode is open |
| SAFE | CoreSimulator/Caches | Simulator dyld caches. Skipped while a simulator is booted |
| SAFE | Old iOS/watchOS/tvOS DeviceSupport | Keeps the most recently used version per platform; rebuilt when a device reconnects |
| SAFE | Unavailable simulators | xcrun simctl delete unavailable (their runtime is gone; they can't boot) |
| SAFE | CocoaPods, SwiftPM, Carthage download caches; React Native Metro/Haste caches | SwiftPM: only ~/Library/Caches/org.swift.swiftpm, never ~/Library/org.swift.swiftpm (config + security fingerprints) |
| ASK | Xcode/Archives | Needed to symbolicate crash reports. Delete old ones in Xcode > Organizer only after their dSYMs are uploaded |
| ASK | Simulator runtimes | xcrun simctl runtime delete <id> for versions nobody targets; Xcode > Settings > Components re-downloads |
| ASK | All simulator devices | xcrun simctl erase all wipes every simulator's apps and data |
| ASK | Extra /Applications/Xcode*.app | 10+ GB each; move unused versions to the Trash |
| NEVER | ~/Library/Application Support/MobileSync/Backup | iPhone/iPad backups: user data, managed only in Finder |
Phase 1c: Editor, AI-tool and leftover sweep
Run scripts/extras-clean.sh [code-folder] (report only), show the totals, ask once, then
scripts/extras-clean.sh --apply. Point it at the user's code folder; it refuses $HOME and system roots.
| Tier | Item | Notes |
SAFE (--apply) | Cursor, VS Code, Windsurf, Antigravity Electron caches | Only Cache, Code Cache, GPUCache, CachedData, CachedProfilesData. Settings and extensions are never touched. Skipped while the editor runs |
| SAFE | Claude Code cache, paste-cache, shell-snapshots; Codex .tmp, cache | Session history, memory and projects are user data and are never listed. Skipped while the tool runs |
| SAFE | ~/.cargo/registry/cache and src | Re-downloaded on the next build |
| REPORT | Unfinished downloads, broken login items, app leftovers, idle project build folders, Docker usage | Listed only. Leftovers are a heuristic: a helper may still use them, so verify before removing |
--apply moves everything to ~/.Trash/mac-dev-cleanup-<date> so it can be undone; space returns when the
Trash is emptied. Every path passes a guard that refuses symlinks, anything outside $HOME, and
Documents, Downloads, Desktop, Pictures and iCloud Drive.
Pairs with Mac Sai, a notarized open-source GUI cleaner
(brew install --cask mac-sai). It has no command line, so an agent cannot drive it from a script; the user
runs its scans. Avoid its Language Files and Universal Binary thinning on a dev machine: both modify
installed apps. Its Trash Bins module empties the Trash, so review the Trash first.
Warning: review every item before cleaning, and don't empty the Trash straight away. On a real dev machine, Mac Sai's
cleanup moved Colima's live VM disks (~/.colima/_lima/...) to the Trash, and emptying the Trash deleted them. The VM kept
running on the deleted files, so everything looked healthy, but stopping it would have lost all Docker images and volumes.
The same run removed about 10,000 duplicate files, including IDs, salary files and contracts, which can break a backup
folder's completeness.
- Never select VM or container disks (
~/.colima,~/.lima, Docker, UTM, Parallels), even when they show up as the biggest items. - Exclude your code, backup and personal document folders from duplicate cleanups.
- If files go missing, check
~/Library/Logs/MacClean/operations.log. - Check a VM after any cleaner run:
lsof -p <VM pid> +L1showing link count 0 on a disk file means it is already deleted. Copy the data out before stopping that VM.
Phase 2: AI-agent worktrees
Coding agents (Claude Code, Codex, etc.) create git worktrees, often a full checkout plus
node_modules, and leave them behind. Run scripts/worktree-audit.sh [root-dir].
It never deletes anything; it classifies each worktree:
| Verdict | Meaning | Action |
| LIVE | A process has its cwd inside, or its agent session wrote in the last 60 min | Never touch |
| SAFE | Clean and fully merged into the default branch | Re-check it's still idle, then git -C <repo> worktree remove --force <wt> && git -C <repo> worktree prune (the branch survives) |
| RESCUE | Uncommitted changes or unmerged commits | Rescue first (below), then remove |
| PHANTOM | Folder isn't a git worktree (stray files) | Move to Trash if idle |
Rescue procedure (ask the user first):
- In the worktree:
git add -A && git commit -m "rescue: uncommitted work from <worktree>" - Save a copy outside the repo:
git diff <default>...HEAD > ~/rescue/<name>.diffandgit format-patch <default>..HEAD -o ~/rescue/<name>/ - Keep the commits reachable:
git branch rescue/<name> HEAD - Then remove:
git worktree unlock <wt>; git worktree remove --force <wt>; git worktree prune
Also check (the script doesn't cover these):
du -sk ~/.codex/worktrees/*/* /private/tmp/* 2>/dev/null | sort -rn | head.
Test runs can leave a full build per run under <worktree>/test-results/, and agents copy whole
source trees into /private/tmp/<project>-*. If a folder has been idle for more than 2 h and no process has its cwd
there (lsof -d cwd | grep <dir>), ask, then move it to the Trash.
Phase 3: RAM / CPU triage
Run scripts/process-triage.sh (report only), then act per finding:
- A single process over ~3 GB is usually the culprit. Check its parent, cwd and CPU over a few samples before acting. Ask before killing anything you didn't start.
- Idle Gradle daemon (~0% CPU, no TCP clients, no build running):
./gradlew --stopin its project, orkill -TERM <pid>. Prevent it: addorg.gradle.daemon.idletimeout=600000to~/.gradle/gradle.properties(daemons exit 10 min after the last build). - Docker/Colima VM with 0 containers (often holds 2–5 GB): ask, then
colima stop(lossless;colima startbrings it back) or quit Docker Desktop. - Docker wedged (VM up,
docker infohangs): ask, thencolima restart. - Colima disk much bigger than
docker system df(orphaned containerd data): ask, then back up~/.colima/default/colima.yaml, runcolima delete --data --force, restore the yaml,colima start. This destroys all images/volumes; projects rebuild their own. - Leaked ChatGPT Codex helpers (the desktop app's app-server starts helper processes per
thread and doesn't reap them; 40+ idle helpers seen): ask, then
scripts/reap-codex-helpers.py(dry run), then--kill. It only touches helpers idle for more than 60 min and never an active task. - Booted simulators hold 1–2 GB each:
xcrun simctl shutdown all(ask if a test run may be using them). SourceKitService over ~2 GB is a known leak; quitting and reopening Xcode releases it. - Zombies can't be killed; if more than 5 share a parent, offer to restart that app.
- Orphans (dev processes whose cwd was deleted): kill them (TERM, then KILL after 5 s) and list what was killed.
- User apps (browsers, chat apps, Electron): report their totals, but never quit one without asking.
Deep options (only on request)
- Stale project dependencies: delete
node_modules/.venv/ios/Podsonly in projects idle 14+ days (no commits, no edits, no running process inside) that have a lockfile. Write each reinstall command (pnpm install,uv sync,pod install, …) to a notes file first. - Docker images: remove only images no container uses (list them explicitly), then
colima ssh -- sudo fstrim -a. Judge the gain withdocker system dfbefore/after (layers are shared). - Old app support folders:
~/Library/Application Supportis often the biggest hog (old IDE versions, browser profiles, Electron caches). Move what you remove to the Trash; don't delete it outright. - Restart: only with no build running. Note that Colima/Docker may not auto-start again.
Hard rules
- Never hard-delete user data: it goes to
~/.Trash, and the user empties it. - Never
rmGradle/browser caches for the user: print the command and let them run it. - Never delete Xcode Archives, simulator app data, or iPhone backups without the user's explicit OK.
- Never delete project
node_modules/.venv, Downloads, or Documents except as the deep option above. - Never kill in-flight builds, processes inside LIVE worktrees, or user-facing apps.
- Root-owned leftovers (from old
sudo npm/sudoinstalls): give the user a one-linesudocommand; never work around permissions. - Report as: free before → free after (df), what was cleaned, what was skipped and why, what needs the user.
Scripts
Save each script to scripts/ next to this file and chmod +x scripts/*. All of them are read-only
except disk-batch.sh (caches only), ios-clean.sh --apply (rebuildable Xcode caches only)
and reap-codex-helpers.py --kill.
scripts/disk-batch.sh
#!/bin/zsh
# disk-batch.sh: safe cache cleanup. Everything here is a re-downloadable cache.
set -u
export PATH="/opt/homebrew/bin:$HOME/.local/bin:/usr/local/bin:/usr/bin:/bin:$PATH"
NODE_BIN="$(ls -d $HOME/.nvm/versions/node/*/bin 2>/dev/null | tail -1)"
[ -n "$NODE_BIN" ] && export PATH="$NODE_BIN:$PATH"
FREE0=$(df -k / | tail -1 | awk '{print $4}')
echo "free before: $(( FREE0 / 1048576 )) GB"
# uv: prune keeps recently used entries; fail fast if a long-lived uvx process holds the lock
if command -v uv >/dev/null; then
OUT=$(UV_LOCK_TIMEOUT=10 uv cache prune 2>&1 | tail -1)
case "$OUT" in
*Timeout*lock*) echo "uv cache busy (held by):"; ps -axo pid,etime,command | grep -E '[u]v tool uvx|[u]vx ' | cut -c1-110;;
*) echo "uv: $OUT";;
esac
fi
command -v npm >/dev/null && npm cache clean --force 2>&1 | tail -1
command -v pnpm >/dev/null && pnpm store prune 2>&1 | tail -1
command -v brew >/dev/null && brew cleanup --prune=all -q 2>&1 | tail -1
rm -rf "$HOME/.bun/install/cache" "$HOME/Library/Caches/pip"
command -v docker >/dev/null && docker info >/dev/null 2>&1 && docker builder prune -f 2>&1 | tail -1
# Colima: return blocks freed inside the VM to macOS (deletes nothing)
if command -v colima >/dev/null && colima status >/dev/null 2>&1; then
colima ssh -- sudo fstrim -a 2>/dev/null && echo "colima disk trimmed"
fi
FREE1=$(df -k / | tail -1 | awk '{print $4}')
echo "free after: $(( FREE1 / 1048576 )) GB (freed $(( (FREE1 - FREE0) / 1024 )) MB)"
echo
echo "CLEAR THESE YOURSELF (close the IDE/browser first):"
if ps -Ao command | grep -qE '[G]radleWrapperMain|[f]lutter (build|run|test)|[x]codebuild'; then
echo " !! a build is RUNNING: wait for it before clearing build caches"
fi
du -sh "$HOME/.gradle/caches" "$HOME/Library/Caches/Google" 2>/dev/null | sed 's/^/ /'
echo ' -> rm -rf ~/.gradle/caches ~/Library/Caches/Google'
command -v xcrun >/dev/null && echo " iOS/Xcode caches: run scripts/ios-clean.sh (report) then --apply"scripts/ios-clean.sh
#!/bin/zsh
# ios-clean.sh [--apply]: Xcode, iOS simulator, CocoaPods, SwiftPM, Carthage and React Native caches.
# Default: report sizes only. --apply: remove the SAFE tier (everything in it rebuilds itself).
# Never touches Archives (needed to symbolicate crash reports), simulator app data, or device backups.
set -u
setopt null_glob
APPLY=0; [ "${1:-}" = "--apply" ] && APPLY=1
D="$HOME/Library/Developer"
TMP="${TMPDIR:-/tmp}"
sz() { [ $# -eq 0 ] && { printf "%7.1f MB" 0; return; }; du -sk "$@" 2>/dev/null | awk '{s+=$1} END{printf "%7.1f MB", s/1024}'; }
safe() { # safe <label> <skip-reason-or-empty> <paths...>
local label=$1 why=$2; shift 2
local s=$(sz "$@")
if [ $# -eq 0 ]; then echo " - $s $label (nothing there)"
elif [ -n "$why" ]; then echo " SKIP $s $label ($why)"
elif [ $APPLY = 1 ]; then rm -rf "$@"; echo " DONE $s $label"
else echo " SAFE $s $label"; fi
}
if ! command -v xcrun >/dev/null || ! xcode-select -p >/dev/null 2>&1; then
echo "Xcode command line tools not found: nothing to clean."; exit 0
fi
FREE0=$(df -k / | tail -1 | awk '{print $4}')
BUILDING=""; ps -Ao command | grep -qE '[x]codebuild|[s]wift-frontend' && BUILDING="a build is running"
XCODE=""; pgrep -x Xcode >/dev/null && XCODE="Xcode is open: quit it first"
BOOTED=$(xcrun simctl list devices booted 2>/dev/null | grep -c Booted)
SIM=""; [ "$BOOTED" -gt 0 ] && SIM="$BOOTED simulator(s) booted: run 'xcrun simctl shutdown all' first"
METRO=""; pgrep -f '[m]etro|react-native start|expo start' >/dev/null && METRO="Metro bundler running"
echo "== SAFE tier (rebuilds itself) $([ $APPLY = 1 ] && echo '— applying' || echo '— report only, re-run with --apply') =="
safe "Xcode DerivedData (build products + index; next build is a full rebuild)" "${BUILDING:-$XCODE}" "$D"/Xcode/DerivedData/*(ND)
safe "Xcode caches" "$XCODE" "$HOME/Library/Caches/com.apple.dt.Xcode"(N)
safe "SwiftUI preview simulators" "$XCODE" "$D"/Xcode/UserData/Previews(N)
safe "Simulator dyld caches" "$SIM" "$D"/CoreSimulator/Caches/*(ND)
# Old device support: keep the most recently used OS version per platform (rebuilt when a device reconnects)
OLD=()
for P in "$D"/Xcode/*OS\ DeviceSupport(N/); do
V=("$P"/*(N/om)); OLD+=("${V[@]:1}")
done
safe "Old iOS/watchOS/tvOS DeviceSupport (newest kept)" "" "${OLD[@]}"
# Simulators whose runtime is gone; simctl removes them and their data folders
UNAV=(${(f)"$(xcrun simctl list devices unavailable 2>/dev/null | grep -oE '[0-9A-F]{8}(-[0-9A-F]{4}){3}-[0-9A-F]{12}')"})
UDIRS=(); for U in "${UNAV[@]}"; do [ -d "$D/CoreSimulator/Devices/$U" ] && UDIRS+=("$D/CoreSimulator/Devices/$U"); done
if [ ${#UNAV} -eq 0 ]; then echo " - $(sz) Unavailable simulators (none)"
elif [ $APPLY = 1 ]; then xcrun simctl delete unavailable && echo " DONE $(sz "${UDIRS[@]}") ${#UNAV} unavailable simulators"
else echo " SAFE $(sz "${UDIRS[@]}") ${#UNAV} unavailable simulators (xcrun simctl delete unavailable)"; fi
safe "CocoaPods download cache" "" "$HOME/Library/Caches/CocoaPods"(N)
# Only the cache: ~/Library/org.swift.swiftpm holds package-collection config and security fingerprints
safe "SwiftPM cache" "$BUILDING" "$HOME/Library/Caches/org.swift.swiftpm"(N)
safe "Carthage cache" "" "$HOME/Library/Caches/org.carthage.CarthageKit"(N)
safe "React Native Metro/Haste caches" "$METRO" "$TMP"/metro-*(N) "$TMP"/haste-map-*(N)
echo
echo "== ASK FIRST (not removed by --apply) =="
A=("$D"/Xcode/Archives/*/*.xcarchive(N))
echo " $(sz "$D"/Xcode/Archives(N)) ${#A} Xcode archives: delete old ones in Xcode > Window > Organizer, only after their dSYMs are uploaded"
echo " $(sz "$D"/CoreSimulator/Devices(N)) all simulator devices: 'xcrun simctl erase all' wipes every simulator's apps and data"
RT=$(xcrun simctl runtime list 2>/dev/null | grep -E '[0-9A-F]{8}(-[0-9A-F]{4}){3}-[0-9A-F]{12}')
if [ -n "$RT" ]; then
echo " simulator runtimes (remove unused ones with 'xcrun simctl runtime delete <id>'; Xcode > Settings > Components re-downloads):"
print -r -- "$RT" | sed 's/^/ /'
else echo " simulator runtimes: none installed as disk images"; fi
XS=(/Applications/Xcode*.app(N/))
(( ${#XS} > 1 )) && echo " ${#XS} Xcode versions installed: ${XS[*]:t} (each 10+ GB; move unused ones to the Trash)"
echo
echo "== NEVER (user data) =="
echo " $(sz "$HOME/Library/Application Support/MobileSync/Backup"(N)) iPhone/iPad backups: manage only in Finder > device > Manage Backups"
FREE1=$(df -k / | tail -1 | awk '{print $4}')
[ $APPLY = 1 ] && echo && echo "freed $(( (FREE1 - FREE0) / 1024 )) MB per df"
exit 0scripts/extras-clean.sh
#!/bin/zsh
# extras-clean.sh [--apply] [project-root]: editor, AI-tool and Cargo caches, plus leftover reports.
# Default: report only. --apply: move the SAFE tier to ~/.Trash/mac-dev-cleanup-<date> (undo by moving it back).
# Everything else is report-only. Coverage and safety ideas adapted from Mac Sai (BSD-3-Clause), see NOTICE.
set -u
setopt null_glob extended_glob
APPLY=0; [ "${1:-}" = "--apply" ] && { APPLY=1; shift; }
ROOT="${1:-$HOME/workspace}"
AS="$HOME/Library/Application Support"
TRASH="$HOME/.Trash/mac-dev-cleanup-$(date +%Y-%m-%d)"
sz() { [ $# -eq 0 ] && { printf "%7.1f MB" 0; return; }; du -sk "$@" 2>/dev/null | awk '{s+=$1} END{printf "%7.1f MB", s/1024}'; }
# Refuse anything that is not a real path inside $HOME's caches: no symlinks, no protected or user-data roots
guard_path() {
local p=$1 r
[ -n "$p" ] && [ -e "$p" ] && [ ! -L "$p" ] || return 1
r=${p:A}
case "$r" in
"$HOME"/Documents*|"$HOME"/Downloads*|"$HOME"/Desktop*|"$HOME"/Pictures*|"$HOME"/Library/Mobile\ Documents*) return 1 ;;
"$HOME"/*) [ "$r" = "$p" ] ;;
*) return 1 ;;
esac
}
safe() { # safe <label> <skip-reason-or-empty> <paths...>
local label=$1 why=$2 p ok=(); shift 2
for p in "$@"; do guard_path "$p" && ok+=("$p") || { [ -e "$p" ] && echo " BLOCK refused by path guard: $p"; }; done
local s=$(sz "${ok[@]}")
if [ ${#ok} -eq 0 ]; then echo " - $s $label (nothing there)"
elif [ -n "$why" ]; then echo " SKIP $s $label ($why)"
elif [ $APPLY = 1 ]; then
for p in "${ok[@]}"; do
mkdir -p "$TRASH${p:h}" && mv "$p" "$TRASH$p"
done
echo " TRASH $s $label"
else echo " SAFE $s $label"; fi
}
running() { pgrep -xq "$1" && echo "$1 is running: quit it first"; }
editor() { # editor <label> <app-support-folder> <process-name>
local b="$AS/$2"
safe "$1 caches" "$(running "$3")" "$b/Cache"(N) "$b/Code Cache"(N) "$b/GPUCache"(N) "$b/CachedData"(N) "$b/CachedProfilesData"(N)
}
echo "== SAFE tier (rebuilds itself) $([ $APPLY = 1 ] && echo "— moving to $TRASH" || echo '— report only, re-run with --apply') =="
editor "Cursor" Cursor Cursor
editor "VS Code" Code Electron
editor "Windsurf" Windsurf Windsurf
editor "Antigravity" Antigravity Antigravity
# Session history, memory and projects are user data and are never listed here
CLAUDE=""; pgrep -q claude && CLAUDE="Claude Code is running"
safe "Claude Code paste and shell caches" "$CLAUDE" "$HOME/.claude/cache"(N) "$HOME/.claude/paste-cache"(N) "$HOME/.claude/shell-snapshots"(N)
CODEX=""; pgrep -q -i codex && CODEX="Codex is running"
safe "Codex temp and cache" "$CODEX" "$HOME/.codex/.tmp"(N) "$HOME/.codex/cache"(N)
CARGO=""; pgrep -xq cargo && CARGO="cargo is running"
safe "Cargo registry downloads (re-downloaded on next build)" "$CARGO" "$HOME/.cargo/registry/cache"(N) "$HOME/.cargo/registry/src"(N)
echo
echo "== UNFINISHED DOWNLOADS (never removed; check them yourself) =="
DL=("$HOME"/Downloads/*.(download|crdownload|part|partial)(N))
if [ ${#DL} -eq 0 ]; then echo " none"; else for f in "${DL[@]}"; do echo " $(sz "$f") ${f:t}"; done; fi
echo
echo "== BROKEN LOGIN ITEMS (program missing; remove with 'launchctl bootout' then delete the plist) =="
N=0
for f in "$HOME"/Library/LaunchAgents/*.plist(N) /Library/LaunchAgents/*.plist(N) /Library/LaunchDaemons/*.plist(N); do
P=$(plutil -extract Program raw -o - "$f" 2>/dev/null || plutil -extract ProgramArguments.0 raw -o - "$f" 2>/dev/null)
case "$P" in /*) [ -e "$P" ] || { echo " ${f:t} -> $P"; N=$((N+1)); } ;; esac
done
[ $N = 0 ] && echo " none"
echo
echo "== APP LEFTOVERS (no installed app matches; verify before removing, a helper may still use them) =="
# shortcut: only reverse-DNS folder names are checked, plain-named folders cannot be matched reliably
IDS=$(for a in /Applications/*.app(N) /Applications/*/*.app(N) "$HOME"/Applications/*.app(N) /System/Applications/*.app(N); do
plutil -extract CFBundleIdentifier raw -o - "$a/Contents/Info.plist" 2>/dev/null
done | tr 'A-Z' 'a-z' | sort -u)
VENDORS=$(print -r -- "$IDS" | cut -d. -f1-2 | sort -u)
for d in "$HOME"/Library/Caches/*(N/) "$AS"/*(N/) "$HOME"/Library/Saved\ Application\ State/*(N/) "$HOME"/Library/HTTPStorages/*(N/) "$HOME"/Library/Containers/*(N/); do
n=${d:t:l}; n=${n%.savedstate}
[[ $n == [a-z0-9-]##.[a-z0-9-]##.* ]] || continue
[[ $n == com.apple.* ]] && continue
print -r -- "$VENDORS" | grep -qx "${n%%.*}.$(print -r -- "$n" | cut -d. -f2)" && continue
echo "$(du -sk "$d" 2>/dev/null | cut -f1) ${d#$HOME/Library/}"
done | sort -rn | head -15 | awk '{k=$1; $1=""; printf " %7.1f MB %s\n", k/1024, $0}'
echo
echo "== IDLE PROJECT BUILD FOLDERS under $ROOT (14+ days untouched; never removed here) =="
case "${ROOT:A}" in
/|/System*|/Library*|/Applications*|/usr*|/bin*|/sbin*|/opt*|"$HOME"|"$HOME"/Library*) echo " refusing to scan ${ROOT:A}: pick a code folder" ;;
*)
find "$ROOT" -maxdepth 6 -type d \( -name node_modules -o -name target -o -name .next -o -name Pods -o -name .venv -o -name venv -o -name build -o -name dist \) -prune 2>/dev/null | while read -r j; do
p=${j:h}
[ -e "$p/package.json" -o -e "$p/Cargo.toml" -o -e "$p/pyproject.toml" -o -e "$p/requirements.txt" -o -e "$p/Podfile" -o -e "$p/build.gradle" -o -e "$p/build.gradle.kts" ] || continue
[ -n "$(find "$p" -maxdepth 2 -type f -mtime -14 -not -path '*/node_modules/*' -not -path '*/.git/*' 2>/dev/null | head -1)" ] && continue
echo "$(du -sk "$j" 2>/dev/null | cut -f1) ${j#$ROOT/}"
done | sort -rn | head -15 | awk '{k=$1; $1=""; printf " %7.1f MB %s\n", k/1024, $0}' ;;
esac
if command -v docker >/dev/null && docker info >/dev/null 2>&1; then
echo
echo "== DOCKER (volumes can hold databases: report only, never pruned) =="
docker system df 2>/dev/null | sed 's/^/ /'
fi
exit 0scripts/process-triage.sh
#!/bin/zsh
# process-triage.sh: RAM/CPU triage. REPORTS ONLY; it kills nothing.
set -u
setopt null_glob 2>/dev/null || true
PY=$(command -v /opt/homebrew/bin/python3 || command -v python3)
echo "== pressure =="
sysctl vm.swapusage | awk '{print "swap used:", $7, " (swap files live on the boot disk, 1 GB each)"}'
uptime | sed 's/.*load/load/'
echo "runnable now: $(ps -Ao stat | awk '$1 ~ /^R/' | wc -l | tr -d ' ') (load avg lags; this is the live number)"
echo
echo "== biggest memory holders (a single process >3 GB = prime suspect) =="
top -l 1 -o mem -n 8 -stats pid,mem,command 2>/dev/null | tail -8 | sed 's/^/ /'
echo
echo "== process families by count (a leak shows up as dozens of one name) =="
ps -axo comm= | sed 's#.*/##' | sort | uniq -c | sort -rn | head -8 | sed 's/^/ /'
echo
echo "== latest macOS memory squeeze (jetsam names the culprit even after it exits) =="
JS=(/Library/Logs/DiagnosticReports/JetsamEvent-*(Nom)); J=${JS[1]:-}
if [ -n "$J" ]; then "$PY" - "$J" <<'PY'
import json, sys, os
d = json.loads(open(sys.argv[1]).read().split('\n', 1)[1])
t = max(d.get('processes', []), key=lambda p: p.get('rpages', 0), default={})
print(f" {os.path.basename(sys.argv[1])[12:29]} largest: {t.get('name','?')} pid {t.get('pid','?')} {t.get('rpages',0)*16384/1073741824:.1f} GB")
PY
else echo " none"; fi
echo
echo "== IN-FLIGHT BUILDS (never kill; don't clear build caches or restart while these run) =="
ps -Ao pid,etime,command | grep -E '[G]radleWrapperMain|[f]lutter (build|run|test)|[x]codebuild|[n]ext build' | grep -vE 'zsh -c|bash -c' | cut -c1-120 | sed 's/^/ /'
echo " (empty = none)"
echo
echo "== GRADLE DAEMONS (idle = ~0% CPU AND no TCP clients -> safe to stop) =="
for P in $(pgrep -f GradleDaemon); do
C=$(lsof -a -p $P -iTCP -sTCP:ESTABLISHED -nP 2>/dev/null | awk 'NR>1' | wc -l | tr -d ' ')
printf " pid=%s up=%s cpu=%s%% tcp-clients=%s\n" $P "$(ps -p $P -o etime= | tr -d ' ')" "$(ps -p $P -o %cpu= | tr -d ' ')" $C
done
pgrep -f GradleDaemon >/dev/null || echo " none"
echo
echo "== XCODE / SIMULATORS =="
if command -v xcrun >/dev/null && xcode-select -p >/dev/null 2>&1; then
B=$(xcrun simctl list devices booted 2>/dev/null | grep -c Booted)
echo " booted simulators: $B (each holds 1-2 GB; 'xcrun simctl shutdown all' frees them)"
ps -axo rss=,comm= | awk '{n=$2; sub(".*/","",n)} n ~ /^(Xcode|SourceKitService|XCBBuildService|swift-frontend|lldb-rpc-server|Simulator|launchd_sim|IBAgent-iOS)$/ {r[n]+=$1; c[n]++} END{for (k in r) printf " %-18s x%-3d %6.0f MB\n", k, c[k], r[k]/1024}'
echo " (SourceKitService over ~2 GB is a known leak: quitting Xcode releases it)"
else echo " Xcode not installed"; fi
echo
echo "== CHATGPT CODEX helper backlog =="
R=$(pgrep -f 'codex.*app-server' | head -1)
if [ -n "$R" ]; then echo " app-server pid $R running -> run scripts/reap-codex-helpers.py (dry run) to count idle helpers"
else echo " not running"; fi
echo
echo "== ZOMBIES (unkillable; restart the PARENT to reap) =="
ps -Aeo pid,ppid,stat,comm | awk '$3 ~ /^Z/ {printf " pid=%s ppid=%s %s\n", $1, $2, $4}' | head -10
ps -Aeo stat | awk '$1 ~ /^Z/' | wc -l | awk '{print " total zombies:", $1}'
echo
echo "== ORPHANS (dev processes whose cwd was deleted: safe kill candidates) =="
for P in $(ps -Ao pid,comm | awk '$2 ~ /(^|\/)(node|bun|deno|python[0-9.]*)$/ {print $1}'); do
CWD=$(lsof -a -p "$P" -d cwd -Fn 2>/dev/null | awk '/^n/ {print substr($0,2)}')
[ -n "$CWD" ] && [ ! -d "$CWD" ] && echo " pid=$P $(ps -o comm= -p $P) cwd-GONE: $CWD"
done
echo " (empty = none)"
echo
echo "== STRAY TEST RUNNERS (parent died, idle) =="
ps -Aeo pid,ppid,etime,pcpu,comm | awk '$2==1 && $5 ~ /(flutter_tester|dartvm|jest|vitest|pytest)/ && $4+0 < 5 {printf " pid=%s age=%s %s\n", $1, $3, $5}' | head -10
echo " (empty = none)"
echo
echo "== DOCKER / COLIMA =="
if command -v colima >/dev/null && colima status >/dev/null 2>&1; then
if ! perl -e 'alarm 15; exec @ARGV' docker info >/dev/null 2>&1; then
echo " WEDGED: colima up but docker unresponsive -> ask, then 'colima restart'"
else
N=$(docker ps -q 2>/dev/null | wc -l | tr -d ' ')
echo " colima running | containers: $N"
[ "$N" = 0 ] && echo " IDLE VM (0 containers) -> ask, then 'colima stop' (lossless)"
docker ps --format ' {{.Names}} ({{.RunningFor}})' 2>/dev/null | head -15
fi
elif pgrep -x "Docker Desktop" >/dev/null || pgrep -f "Docker.app" >/dev/null; then
echo " Docker Desktop running | containers: $(docker ps -q 2>/dev/null | wc -l | tr -d ' ')"
else echo " not running"; fiscripts/worktree-audit.sh
#!/bin/zsh
# worktree-audit.sh [root]: find agent worktrees and classify LIVE / SAFE / RESCUE / PHANTOM.
# Prints TSV: verdict, size MB, path, detail. NEVER deletes anything.
set -u
ROOT="${1:-$HOME}"
find "$ROOT" \( -name node_modules -o -name Library -o -name .Trash -o -name .git \) -prune \
-o -type d -path '*/.claude/worktrees' -print 2>/dev/null \
| while read -r WTDIR; do
REPO="${WTDIR%/.claude/worktrees}"
for WT in "$WTDIR"/*(N/); do
if [ ! -e "$WT/.git" ]; then
echo -e "PHANTOM\t$(du -sm "$WT" 2>/dev/null | cut -f1)\t$WT\tnot a git worktree (stray files): Trash if idle"; continue
fi
# LIVE (1): a process has its cwd inside (deleting it would break that session)
if lsof +D "$WT" 2>/dev/null | awk 'NR>1 && $4=="cwd"' | grep -q .; then
echo -e "LIVE\t$(du -sm "$WT" 2>/dev/null | cut -f1)\t$WT\tactive process inside: DO NOT TOUCH"; continue
fi
# LIVE (2): Claude Code in-process subagent; its transcript sits under the owning session
LIVE_WHY=""
for SUB in $HOME/.claude/projects/*/*/subagents/${WT:t}.jsonl(N); do
[ -n "$(find "${SUB:h:h}.jsonl" -mmin -60 2>/dev/null)" ] && LIVE_WHY="owning agent session wrote <60 min ago"
done
# LIVE (3): a Claude Code session opened directly inside the worktree
SLUG=$(print -r -- "$WT" | tr '/.' '--')
if [ -z "$LIVE_WHY" ] && [ -n "$(find "$HOME/.claude/projects/$SLUG" -maxdepth 1 -name '*.jsonl' -mmin -60 2>/dev/null | head -1)" ]; then
LIVE_WHY="a session inside this worktree wrote <60 min ago"
fi
if [ -n "$LIVE_WHY" ]; then
echo -e "LIVE\t$(du -sm "$WT" 2>/dev/null | cut -f1)\t$WT\t$LIVE_WHY: DO NOT TOUCH"; continue
fi
DEFAULT=$(git -C "$REPO" symbolic-ref --short HEAD 2>/dev/null || echo main)
DIRTY=$(git -C "$WT" status --porcelain 2>/dev/null | wc -l | tr -d ' ')
AHEAD=$(git -C "$WT" rev-list --count "$DEFAULT..HEAD" 2>/dev/null || echo 0)
SZ=$(du -sm "$WT" 2>/dev/null | cut -f1)
if [ "$DIRTY" -eq 0 ] && [ "$AHEAD" -eq 0 ]; then
echo -e "SAFE\t$SZ\t$WT\tclean + merged into $DEFAULT (branch survives removal)"
else
echo -e "RESCUE\t$SZ\t$WT\tdirty=$DIRTY unmerged=$AHEAD: save patch/branch before removing"
fi
done
donescripts/reap-codex-helpers.py
#!/usr/bin/env python3
"""Stop idle helper processes leaked by the ChatGPT desktop app's Codex app-server. Dry run unless --kill.
Targets ONLY descendants that are >60 min old AND <1% CPU, skipping codex-named hosts, the app-server,
ChatGPT itself, and every ancestor of a young/busy process (so a running Codex task is never touched).
"""
import collections, ctypes, os, re, signal, subprocess, sys, time
lib = ctypes.CDLL('/usr/lib/libproc.dylib')
class RU(ctypes.Structure):
_fields_ = [('uuid', ctypes.c_uint8 * 16)] + [(n, ctypes.c_uint64) for n in (
'utime', 'stime', 'pkg_idle', 'intr', 'pageins', 'wired', 'resident', 'footprint', 'start', 'exit',
'cutime', 'cstime', 'cpkg', 'cintr', 'cpageins', 'celapsed', 'bytes_read', 'bytes_written')]
def fp(p):
r = RU(); return r.footprint if lib.proc_pid_rusage(p, 2, ctypes.byref(r)) == 0 else 0
def mins(et):
et = et.strip(); days = 0
if '-' in et: d, et = et.split('-', 1); days = int(d)
p = [int(x) for x in et.split(':')]
while len(p) < 3: p.insert(0, 0)
return days * 1440 + p[0] * 60 + p[1]
alive = lambda p: subprocess.run(['kill', '-0', str(p)], capture_output=True).returncode == 0
rows = [l.split(None, 4) for l in subprocess.run(['ps', '-Ao', 'pid=,ppid=,etime=,%cpu=,command='], capture_output=True, text=True).stdout.splitlines()]
procs = {int(r[0]): (int(r[1]), r[2], float(r[3]), r[4]) for r in rows if len(r) == 5}
root = next((p for p, v in procs.items() if re.search(r'ChatGPT\.app/.*codex( |$)|CodexCLI\.app/Contents/MacOS/codex', v[3]) and 'app-server' in v[3]), None)
if not root: sys.exit("Codex app-server not running: nothing to do.")
chatgpt = next((p for p, v in procs.items() if v[3].startswith('/Applications/ChatGPT.app/Contents/MacOS/ChatGPT')), None)
kids = collections.defaultdict(list)
for p, v in procs.items(): kids[v[0]].append(p)
d, s = [], [root]
while s:
for c in kids[s.pop()]: d.append(c); s.append(c)
protect = {root, chatgpt, os.getpid()}
for y in [x for x in d if mins(procs[x][1]) <= 60 or procs[x][2] >= 1.0]:
q = y
while q in procs and q != root: protect.add(q); q = procs[q][0]
targets = [x for x in d if x not in protect and mins(procs[x][1]) > 60 and procs[x][2] < 1.0
and not re.search(r'codex', os.path.basename(procs[x][3].split()[0]), re.I)]
mem = sum(fp(x) for x in targets)
print(f"app-server {root}: {len(d)} descendants; idle targets: {len(targets)} (~{mem/1073741824:.2f} GB)")
if '--kill' not in sys.argv:
print("dry run: re-run with --kill to stop them"); sys.exit(0)
for x in targets:
try: os.kill(x, signal.SIGTERM)
except ProcessLookupError: pass
time.sleep(6)
left = [x for x in targets if alive(x)]
for x in left:
try: os.kill(x, signal.SIGKILL)
except ProcessLookupError: pass
print(f"stopped {len(targets)} (SIGTERM {len(targets) - len(left)}, SIGKILL {len(left)}) | app-server: "
f"{'running' if alive(root) else 'GONE'} | ChatGPT: {'running' if chatgpt and alive(chatgpt) else 'not found'}")Optional: weekly auto-clean
To run Phase 1 every Monday at 10:00, create ~/Library/LaunchAgents/local.cache-cleanup.plist
with a ProgramArguments of /bin/zsh <path>/scripts/disk-batch.sh, a StartCalendarInterval
of Weekday 1, Hour 10, and StandardOutPath set to a log file. Then load it with
launchctl load ~/Library/LaunchAgents/local.cache-cleanup.plist.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

