Measure on-disk size
Walk the selected root and report actual allocated bytes, not just apparent file length.
v0.2.0 source-available macOS TUI
Classify disk usage before you Reclaim it.
macclean scans your Mac, groups each Item by Safety Class, shows the Evidence behind the label, and waits for an explicit Confirm before anything is Reclaimed.
- Runs locally
- No telemetry
- No sudo install
- Explicit Confirm gate
Warning: macclean Reclaims space by deleting files. It is a personal research project, provided as-is with no warranty, no support, and no liability accepted by the author.
The path to deletion stays visible.
macclean is built around recoverability. It avoids vague labels like junk, keeps the proof next to the action, and makes batch Reclaim pass through the same Confirm gate.
Assign Safety Class
Rules label each Item by recovery cost. Unknown paths fail safe to Unclassified.
Read Evidence
Each class keeps concrete Evidence and a Recovery Method close to the Item.
Reclaim deliberately
Reclaimable Items are deleted only after Confirm. Protected data is never offered.
Seven Safety Classes, one conservative default.
Only Regenerable, Reinstallable, Cache, and Redundant Copy are offered for Reclaim by default. Browser Cache and Unclassified require override. Irreplaceable is Protected.
Regenerable
Build output such as Rust `target/`, Flutter `build/`, or Next.js `.next/`.
Recovery: rebuild
Reinstallable
Dependency trees such as `node_modules` that a package manager restores.
Recovery: reinstall
Cache
Tool caches that refill automatically on next use.
Recovery: auto-refill
Browser Cache
Browser cache directories. Rebuildable, but clearing them has a real browsing cost.
Override required
Redundant Copy
A byte-identical duplicate confirmed by checksum, with the surviving copy preserved.
Recovery: original copy
Unclassified
Large Items the Ruleset cannot prove recoverable. Surfaced for awareness, not auto-offered.
Override required
Irreplaceable
Databases, VM volumes, documents, and other real data that should not be deleted by the tool.
ProtectedInstall with one command.
The installer fetches the latest universal macOS binary from GitHub Releases, verifies its SHA-256 checksum, installs to `~/.local/bin`, and updates `~/.zshrc` when needed.
curl -fsSL https://macclean.commaco.tech/install.sh | sh