| name | disk-magician-codex |
| description | Use when a Codex agent needs disk usage diagnosis, growth history, or repository-gated cleanup guidance. |
Disk Magician — Codex Agent Skill
This skill teaches Codex how to integrate with disk_magician to perform automated node maintenance, monitor filesystem regressions, and safely delete orphaned resources.
Usage Guide for Codex
- Run the default diagnosis first:
Launch top-down 5 GiB accounting, coverage-validated deltas, and safe quick wins concurrently:
disk-magician audit
Follow the full forensic procedure in ../disk-root-cause/SKILL.md when deeper attribution is needed. Residual is not backup size or reclaimable without evidence.
- Retrieve Growth Regression Log:
Query the Git snapshot database to review recent space regressions:
./disk_magician.sh history
- Preview maintenance:
Keep cleanup behind the repository safety gates:
./disk_magician.sh clean
Codex Safety Policies
- Codex agent session files inside
~/.codex/sessions are protected under the global AGENTS policy and must never be deleted unless explicitly requested.
- Respect the mtime safety rule: any worktree folder modified < 14 days ago requires explicit
WORKTREE APPROVED user authorization.
