MacSweep v1.0.0
First release of MacSweep — a CLI-first macOS system cleaner. Distributed via Homebrew, built from source (no Apple code signing yet).
Install
brew tap VincentShipsIt/macsweep https://github.com/VincentShipsIt/macsweep
brew trust --formula vincentshipsit/macsweep/macsweep # recent Homebrew requires this for 3rd-party taps
brew install VincentShipsIt/macsweep/macsweep
# bleeding edge instead: brew install --HEAD VincentShipsIt/macsweep/macsweepHighlights
- 21 CLI commands:
scan/dry-run/apply,maintenance,permissions,modules,space+space lens,login-items,uninstall,ai,malware scan,homebrew,shred,version. - 19 cleanup modules: browser caches (Arc/Brave/Chrome/Firefox/Safari), developer-tool & package-manager caches (npm/yarn/pnpm/bun/pip/cargo/go/gradle/maven/mise/sccache/deno/…), Docker, duplicates, similar photos, large files, mail attachments, privacy, network, service workers, system caches, trash.
- Safety-first: default-deny SafetyChecker, cloud-sync directories protected, move-to-Trash (recoverable) by default — irreversible hard delete only via the explicit
shredcommand. - Scriptable: semantic exit codes (0 success, 2 usage, 3 confirmation-required, 4 not-found, 5 refused) and JSON output for agent/automation use.
- Optional AI analysis (Claude) for cache and malware findings.
Requires macOS 13 (Ventura) or later.