Skip to content
Core-X Docs

Disk Study

(Disk Usage + Cleanup)

A separate repo (~/corex-disk-study/) for safe macOS disk analysis and cleanup planning. Safety-first: SAFE-only targets, Trash-only deletes, gated confirmation, dry-run by default.

Terminal window
cd ~/corex-disk-study
python3.12 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"


corex disk study --path ~ --export ./var/reports/disk-study/
corex disk plan --export ./var/reports/disk-study/
corex disk apply --plan ./var/reports/disk-study/<plan>.json --dry-run
corex disk snapshots    # list previous study snapshots

No Core-X services required — runs fully offline against the local filesystem.

Safety Gates

  • SAFE-only targets: Only analyzes directories the OS marks as safe to clean
  • Trash-only deletes: Files go to macOS Trash, never rm -rf
  • Gated confirmation: Interactive prompts before any destructive action
  • Dry-run default: disk apply requires explicit --no-dry-run to execute
  • Snapshot history: Every study is saved; compare over time with disk snapshots