Skip to content

MacSweep v1.0.0

Choose a tag to compare

@VincentShipsIt VincentShipsIt released this 13 Jun 20:00

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/macsweep

Highlights

  • 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 shred command.
  • 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.