Open source · macOS 15+
Free up disk space on your Mac, with an agent that understands what it's deleting.
Freeroom is a menu bar app for developers. It finds what's eating your disk (Docker build cache, Xcode simulator runtimes, node_modules, Go, NuGet and npm caches, local AI models, forgotten archives), explains each item, classifies it as Safe, Review or Keep, and only deletes what you confirm.
Download Freeroom 1.0.0 View on GitHub
Requires macOS 15 or later. Runs on Apple silicon and Intel. Free and MIT licensed. Signed with Developer ID and notarized by Apple.
Safe · Review · Keep
Every finding comes with a verdict and an explanation
-
Safe
Regenerable: it comes back when needed. Freed only after you confirm, with the tool's own cleanup command when there is one.
-
Review
Worth a look first, such as old archives or personal files. If you confirm, it goes to the Trash, so you can recover it.
-
Keep
Large, but kept. Freeroom never deletes these. They are listed so you know where your space goes.
Features
Everything Freeroom does
Free space in the menu bar
See your free space at a glance and open the biggest safe wins straight from the menu bar.
Simple and Detailed modes
Simple: big icons and one button. Detailed: disk map, list and inspector. Switch anytime in the toolbar.
Disk map and ecosystems
A treemap of everything that can be reclaimed. Group findings by ecosystem (Xcode, Docker, Node, Go, AI models and more) or list them by size.
240 known locations
A curated catalog of caches, build output and tool data, each shown with the official icon of its app or brand so you recognize it instantly.
Explanations, not just sizes
The inspector tells you what each item is, why it's safe or why to review it, and shows the evidence and paths behind the verdict.
Rule engine, no AI
Freeroom checks your disk every 6 hours (configurable) with its rules, no AI and no tokens, and sends at most one notification a day. A heads-up, not a nag.
Accurate measurement
Hard links are counted once, other volumes such as mounted simulator runtimes are not entered, APFS volume groups are not counted twice, and symlinks are never followed.
You confirm, it cleans
Nothing is deleted without your confirmation. Each item is re-checked right before cleaning, and only allowlisted cleanup commands run.
Claude Code plugin (optional)
/freeroom:scan lets your own Claude Code explain what rules can't (old archives, abandoned projects), and /freeroom:translate shows the explanations in your language. It uses the Claude Code you already have: no API key. The agent can measure and report. It cannot delete.
History of cleanups and scans
See how much you freed in total, every cleanup and every rule check or Claude Code scan, and export a report of any scan.
16 languages, your text size, light and dark
The app speaks 16 languages, offers small, medium and large text, and follows light and dark mode.
Homebrew and the freeroom CLI
Install with Homebrew and get the freeroom command line tool too: run an AI-free scan with freeroom rules or measure any folder with freeroom measure.
Complete uninstall
Settings › About › Uninstall Freeroom lists every location it removes and moves the app to the Trash. With Homebrew, brew uninstall --zap removes everything.
Signed and notarized
Every release is signed with Developer ID and notarized by Apple, built in the open by GitHub Actions.
Private by design
Freeroom stores everything locally and sends nothing about you. Its only network request is an optional daily check for plugin updates on GitHub, which you can turn off. The optional Claude Code plugin runs inside your own Claude Code.
A closer look
Screenshots use demo data.
Safety
Built so it can't surprise you
- The agent cannot delete: the CLI has no delete command.
- The app deletes only after you confirm, and only inside your home folder. It never touches protected folders (~/Documents, ~/Library, ~/.ssh, Keychains).
- Cleanup commands run only if they are on an allowlist (docker builder prune, xcrun simctl runtime delete, go clean -modcache and similar), without a shell. Anything else is shown to you to run yourself.
- Review items go to the Trash, not straight to deletion.
- Freeroom never touches your Claude credentials.
Install
Get Freeroom
Download the app
Open the DMG and drag Freeroom to Applications. Requires macOS 15 or later.
Or use Homebrew
Homebrew asks you to trust third-party casks once, then installs the app and the freeroom CLI.
brew trust --cask hblabs-co/tap/freeroom
brew install --cask hblabs-co/tap/freeroomAdd the Claude Code plugin
Optional. In Claude Code, run the command below. When Claude Code asks, choose “Install for you (user scope)”: the plugin then works in every folder and Freeroom can detect it. Then run /freeroom:scan.
/plugin install freeroom --marketplace hblabs-co/freeroomFeature requests
Missing something?
Tell us what Freeroom should do next. Your request goes straight to the team by email.
The form is not available right now. Send your request by email to [email protected]