OpenSweep

OpenSweep is a minimal, free and open source macOS cleaner for reclaiming space from user-owned caches, logs, Trash contents, browser caches, and common developer build artifacts.

Features

• Preview-first scanning with per-item selection.
• User-home safety policy that blocks root, system, and broad Library deletion.
• Cache and log cleanup moves items to Trash where macOS supports it.
• Trash cleanup is opt-in and permanently deletes only selected Trash items.
• Optional browser-cache and developer-data categories.
• Start at login support from the Settings window.
• Native SwiftUI desktop UI with toolbar actions, search, settings, and menus.

Download And Install

Option 1: Install From A Release

1. Download OpenSweep-macOS.zip from the latest GitHub release.
2. Double-click the zip file.
3. Drag OpenSweep.app into your Applications folder.
4. Open Launchpad or Spotlight, search for OpenSweep, and press Return.
5. If macOS says the app cannot be opened because it was downloaded from the internet, right-click OpenSweep.app in Applications, choose Open, then choose Open again.

Option 2: Build It Yourself

Install Xcode Command Line Tools, then run:

git clone https://github.com/yashrajnayak/OpenSweep.git
cd OpenSweep
swift run OpenSweepSelfTest
./script/package_release.sh
open dist/release/OpenSweep.app

The packaged zip is created at:

dist/OpenSweep-macOS.zip

Use OpenSweep

1. Click Scan.
2. Review the cleanup categories and deselect anything you want to keep.
3. Click Clean.
4. Confirm the cleanup prompt.

Caches, logs, and developer artifacts are moved to Trash. Trash items are not selected by default because they are deleted permanently when you choose them.

Start At Startup

1. Open OpenSweep.
2. Choose OpenSweep > Settings.
3. Turn on Start OpenSweep at login.
4. If macOS asks for approval, click Open Login Items and allow OpenSweep in System Settings.

Start-at-login works best after OpenSweep.app has been moved into the Applications folder.

Start Again If You Quit

• Open Launchpad or Spotlight, search for OpenSweep, and press Return.
• Or open Finder > Applications and double-click OpenSweep.app.
• To keep it available after restarts, turn on Start OpenSweep at login in OpenSweep > Settings.

Architecture

flowchart LR
    App["SwiftUI App"] --> Store["CleanerStore"]
    Store --> Scanner["CleanerScanner"]
    Store --> Cleaner["CleanerService"]
    Scanner --> Policy["SafetyPolicy"]
    Cleaner --> Policy
    Scanner --> FS["User-owned filesystem"]
    Cleaner --> FS

Loading

Build And Run

swift run OpenSweepSelfTest
./script/build_and_run.sh --verify
./script/package_release.sh

The Codex Run action is wired to:

./script/build_and_run.sh

Safety Model

OpenSweep only scans paths under the current user's home directory. It refuses to clean the home folder itself, broad Library roots, and category roots such as ~/Library/Caches, ~/Library/Logs, and ~/.Trash. Scans produce top-level cleanup candidates, and every candidate remains user-selectable before cleaning.

License

MIT. See LICENSE.