Skip to content

MacSweep Logo

MacSweep

An open-source, transparent, and privacy-first macOS system cleaner, storage analyzer, and developer-cache manager.

CI Status License Swift Version Platform Direct Download


Key Features

  • Smart Scan: Unified discovery of system caches, application logs, temporary files, and Trash items.
  • Developer Cache Cleaner: Targeted cleaning of Xcode DerivedData, SPM caches, CocoaPods, Gradle, Android build caches, npm, pnpm, Yarn, Bun, Homebrew, and Docker artifacts.
  • Interactive Storage Analyzer: Visual folder tree and disk usage breakdown.
  • Large File Finder: Discover large files over configurable thresholds (500 MB to 10 GB+).
  • Safe Duplicate Detection: Multi-stage content hash engine for discovering duplicate copies safely.
  • App Uninstaller: Complete leftover file discovery for uninstalled applications.
  • Safety First: Hardcoded system safeguards, symlink resolution, explicit review, and confirmation before cleanup.
  • Secure Updates: Automatic updates signed with a dedicated Sparkle EdDSA key.
  • Privacy First: 100% local scanning, zero telemetry, zero analytics tracking, zero cloud server uploads.

Installation & Distribution

MacSweep is distributed as an open-source Direct Download package through GitHub Releases. Current packages use an ad-hoc signature and are not Apple-notarized.

Direct Download

Download the latest .dmg installer from GitHub Releases.

  1. Download MacSweep.dmg.
  2. Open the DMG file and drag MacSweep into your Applications folder.
  3. The first time you launch it, Control-click MacSweep, choose Open, then confirm Open.
  4. Grant Full Disk Access when prompted.

Building From Source

git clone https://github.com/opencorex-org/macsweep.git
cd macsweep
open MacSweep.xcodeproj

Select the MacSweep scheme in Xcode and press Cmd + R.


Architecture & Safety

MacSweep decouples file discovery from deletion:

[ Scanner Engine ] ──▶ [ Safety Validator ] ──▶ [ User Review ] ──▶ [ Confirmed Cleanup ]
  • Scanner: Read-only path enumerator. Cannot delete files.
  • Safety Validator: Validates candidate paths against system boundaries (/System, /usr, /Library/Keychains) and verifies canonical symlinks.
  • Cleanup Engine: Permanently removes approved cleaner items. Large Files and App Uninstaller remain recoverable through the macOS Trash.

For full technical documentation, see docs/architecture.md and docs/permissions.md.


Documentation


License

MacSweep is open-source software licensed under the Apache License 2.0. Developed under the OpenCorex organization.

About

Open-source macOS cleaner and developer cache manager

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages