disk-magician-claude | claude-commands

Stats

Actions

Tags

disk-magician-claude | claude-commands

Disk Magician — Claude Skill

This skill teaches Claude how to use disk_magician to audit disk space, identify growth regressions, and perform cleanups.

Skill Integration & Commands

Snapshot Validation (Phase 0): Check the coverage and timeouts of the snapshot file located in your backup repository:
```
./disk_magician.sh audit --dry-run
```
Check the output to make sure coverage is >= 70% and there are no warnings.
Scan / Discover (Phase 1): Scan for directories > 5 GB not currently in the monitored configuration:
```
./disk_magician.sh discover
```
Audit Candidates (Phase 2): View cleanup candidates and regressions:
```
./disk_magician.sh audit
```
Safe Cleanup (Phase 3): Execute safe cache and temp cleanups (which deletes stale temporary PR clones, dev caches, and orphaned worktrees):
```
./disk_magician.sh clean
```
Destructive Cleanup (Phase 4): Interactively clear Docker VM disk images, Colima VMs, and old agent session folders:
```
./disk_magician.sh clean-all
```

Safety Constraints & Guardrails

Mtime Caution: Worktrees and agent sessions with modification time < 14 days require explicit WORKTREE APPROVED confirmation from the user before deletion.
Never-delete list: Do not delete ~/.codex/sessions, ~/.codex/sessions_archive/, ~/.codex/state*.sqlite, ~/.codex/log, or ~/.claude/projects directly. Always run cleanups through disk_magician.sh to ensure safety filters are respected.