Repository navigation
Releases
Freeroom 1.0.0
Install
brew trust --cask hblabs-co/tap/freeroom # Homebrew asks you to trust third-party casks once
brew install --cask hblabs-co/tap/freeroomOr download Freeroom-1.0.0.dmg below. Signed with Developer ID and notarized by Apple.
Apple silicon and Intel (universal), macOS 15 or later.
Freeroom 1.0
The first stable release. Freeroom finds what fills your Mac (Docker and Xcode caches,
node_modules, package-manager caches, local AI models, forgotten archives…), explains each item,
classifies it as Safe, Review or Keep, and only deletes what you confirm.
- Menu bar app with Simple and Detailed modes, disk map, grouping by ecosystem.
- Catalog of ~240 known locations with official app icons; accurate measurement (no double counting
of hard links or APFS volumes). - Rule engine every 6 hours, no AI involved; at most one notification a day.
- Optional Claude Code plugin (
/freeroom:scan,/freeroom:translate): your own Claude Code
measures and explains, but only the app deletes, after you confirm. - History of cleanups and scans, exportable report, 16 languages, text size, light and dark mode,
complete uninstall.
What changed since 0.1.1
- Universal build: runs natively on Apple silicon and Intel Macs.
- The sidebar keeps its width after the window grows (it could end up squeezed in Detailed mode).
- Releases are now built, signed, notarized and published by GitHub Actions.
The Claude Code plugin is unchanged (0.1.0).
Freeroom 0.1.1
Install
brew trust --cask hblabs-co/tap/freeroom # Homebrew asks you to trust third-party casks once
brew install --cask hblabs-co/tap/freeroomOr download Freeroom-0.1.1.dmg below (signed with Developer ID and notarized by Apple).
Fixes
- No more freeze while checking the disk. The animated menu bar icon kept the app's main thread busy for the whole scan, so the window stopped responding (for example after "Skip: rules only"). The animation is now light and only runs while a scan is in progress.
- First check shows results as they are found instead of a spinner for a minute. Later checks keep showing the last complete results until the new ones are ready.
- Uninstall shows its progress: each step with a checkmark, a "Freeroom was uninstalled" confirmation, any paths that could not be removed, and the app reliably quits afterwards (it used to keep running from the Trash).
Improvements
- Plugin install instructions now say to choose "Install for you (user scope)" in Claude Code, so the plugin works in every folder and Freeroom detects it.
- Settings › About shows the
brew truststep.
The Claude Code plugin is unchanged (0.1.0).
Freeroom 0.1.0
First public release of Freeroom, by HB Labs SAS — free up disk space on macOS with an agent that understands what it is deleting.
Install
brew trust --cask hblabs-co/tap/freeroom # Homebrew asks you to trust third-party casks once
brew install --cask hblabs-co/tap/freeroomor download Freeroom-0.1.0.dmg below (signed with Developer ID and notarized by Apple). Requires macOS 15 Sequoia or later.
Optional, for the deep analysis in your own Claude Code:
/plugin install freeroom --marketplace hblabs-co/freeroom
What's in 0.1.0
- Menu bar app with Simple and Detailed modes, disk map, official app icons and brand logos
- Rule engine (no AI): 240 known macOS locations, Docker, Xcode simulators and verified build folders, measured without double counting (hard links, mounted volumes, APFS volume groups)
- Claude Code plugin (
/freeroom:scan,/freeroom:translate): the agent measures and reports, but cannot delete - Safe cleaning: confirmation sheet, allowlisted tool commands run without a shell, protected folders, review items go to the Trash
- History of cleanups and of every scan, with Markdown export
- Notifications (rules only, at most one per day), plugin update notices
- 16 languages, three text sizes, light and dark mode
- Complete uninstall:
brew uninstall --zap --cask freeroom, or Settings › About › Uninstall
Open source under the MIT license.