disk-janitorlisted
Install: claude install-skill cmin764/configs
# Disk Janitor
Detect and reclaim wasted space on macOS via `scripts/cleanup.py`. The script
is stdlib-only (no deps), dry-run by default, and delegates to each tool's own
CLI for package-manager caches rather than deleting files directly.
---
## Workflow
1. Run the dry-run report first — always:
```bash
python3 .claude/skills/disk-janitor/scripts/cleanup.py --level 2
```
2. Show the output to the user. Let them choose a level and confirm targets.
3. Run with `--apply` at the agreed level:
```bash
python3 .claude/skills/disk-janitor/scripts/cleanup.py --level 2 --apply
```
4. Report the before/after free-space delta from the script output.
If the user only wants to understand space usage (no cleanup), `--level 3`
dry-run gives the fullest picture without touching anything.
---
## Levels
| Level | What it covers | Risk |
|-------|---------------|------|
| 1 (default) | Package-manager caches via official CLIs: brew, uv, pip, npm, bun | Low |
| 2 | + Chrome/JetBrains/IDE caches, ~/Library/Logs, Claude shell/paste cache, Claude chats older than N days, docker prune -f (dangling images + build cache only, tagged images untouched) | Low-med |
| 3 | + Stale node_modules (projects untouched > N days), Xcode artifacts, brew --prune=all, docker prune -a (ALL unused images, confirm required), Claude plugin caches: cached node_modules, marketplace `.git` dirs, large tracked binaries (PDFs/zips/media) in marketplace working trees | Med (rebuild cost) |
| dangero