开源 · macOS 15 及更高版本
释放 Mac 的磁盘空间,交给一个清楚自己在删什么的智能体。
Freeroom 是一款面向开发者的菜单栏 App。它会找出占用磁盘的内容(Docker 构建缓存、Xcode 模拟器运行时、node_modules、Go、NuGet 和 npm 缓存、本地 AI 模型、被遗忘的归档文件),逐项说明,归类为“安全”“待检查”或“保留”,并且只删除你确认过的内容。
下载 Freeroom 1.0.0 在 GitHub 上查看
需要 macOS 15 或更高版本。支持 Apple silicon 和 Intel。 免费,采用 MIT 许可证。使用 Developer ID 签名,并经过 Apple 公证。
安全 · 待检查 · 保留
每一项发现都附有判定和说明
-
安全
可再生:需要时会自动重新生成。只有在你确认后才会释放;如果工具自带清理命令,就用它来清理。
-
待检查
建议先看一眼,比如旧归档或个人文件。确认后会移到废纸篓,因此可以恢复。
-
保留
占用大但保留。Freeroom 绝不会删除这些项目。列出它们是为了让你了解空间的去向。
功能
Freeroom 能做的一切
在菜单栏中显示可用空间
一眼看清可用空间,直接从菜单栏打开可安全释放的大项。
简洁模式和详细模式
简洁:大图标加一个按钮。详细:磁盘地图、列表和检查器。随时可在工具栏中切换。
磁盘地图和生态
用树状图展示所有可回收的内容。可以按生态(Xcode、Docker、Node、Go、AI 模型等)分组,也可以按大小列出。
240 个已知位置
精心整理的缓存、构建产物和工具数据目录,每一项都配有对应 App 或品牌的官方图标,一眼就能认出。
不只有大小,还有说明
检查器会告诉你每一项是什么、为什么安全或为什么需要检查,并展示判定背后的依据和路径。
规则引擎,不用 AI
Freeroom 每 6 小时(可调整)用内置规则检查一次磁盘,不使用 AI,也不消耗 token,每天最多发送一条通知。适时提醒,绝不打扰。
精确测量
硬链接只计算一次,不进入其他宗卷(例如已挂载的模拟器运行时),APFS 宗卷组不会重复计算,也从不跟随符号链接。
你确认后才清理
未经你确认,不会删除任何内容。每一项在清理前都会重新检查,而且只运行允许列表中的清理命令。
Claude Code 插件(可选)
借助 /freeroom:scan,你自己的 Claude Code 可以解释规则无法判断的内容(旧归档、废弃项目);/freeroom:translate 则用你的语言显示这些说明。它使用你已有的 Claude Code,无需 API 密钥。智能体只能测量和报告,无法删除。
清理和扫描历史记录
查看累计释放了多少空间、每一次清理,以及每一次规则检查或 Claude Code 扫描,还可以导出任意一次扫描的报告。
16 种语言,文字大小随心,浅色深色皆宜
App 支持 16 种语言,提供小、中、大三种文字大小,并跟随浅色和深色模式。
Homebrew 和 freeroom CLI
通过 Homebrew 安装,还能同时获得 freeroom 命令行工具:用 freeroom rules 运行不使用 AI 的扫描,或用 freeroom measure 测量任意文件夹。
彻底卸载
“设置 › 关于 › 卸载 Freeroom”会列出将要移除的每一个位置,并把 App 移到废纸篓。如果通过 Homebrew 安装,brew uninstall --zap 会移除所有内容。
已签名并经过公证
每个版本都使用 Developer ID 签名并经过 Apple 公证,由 GitHub Actions 公开构建。
从设计上保护隐私
Freeroom 将所有内容保存在本地,不发送任何关于你的信息。它唯一的网络请求是每天在 GitHub 上检查一次插件更新,这项功能是可选的,可以关闭。可选的 Claude Code 插件在你自己的 Claude Code 中运行。
细节一览
截图使用的是演示数据。
安全性
精心设计,绝无意外
- 智能体无法删除:CLI 中根本没有删除命令。
- App 只在你确认后才删除,而且只在你的个人文件夹内删除。它从不触碰受保护的文件夹(~/Documents、~/Library、~/.ssh、钥匙串)。
- 清理命令只有在允许列表中(docker builder prune、xcrun simctl runtime delete、go clean -modcache 等)才会运行,并且不经过 shell。其他命令只会展示给你,由你自己运行。
- “待检查”项会移到废纸篓,而不是直接删除。
- Freeroom 从不触碰你的 Claude 凭据。
安装
获取 Freeroom
或使用 Homebrew
Homebrew 会先请你信任一次第三方 cask,然后安装 App 和 freeroom CLI。
brew trust --cask hblabs-co/tap/freeroom
brew install --cask hblabs-co/tap/freeroom添加 Claude Code 插件
可选。在 Claude Code 中运行下面的命令。当 Claude Code 询问时,请选择“Install for you (user scope)”:这样插件在所有文件夹中都能使用,Freeroom 也能检测到它。然后运行 /freeroom:scan。
/plugin install freeroom --marketplace hblabs-co/freeroom功能建议
还缺点什么?
告诉我们 Freeroom 下一步该做什么。你的建议会通过电子邮件直接发送给团队。
表单暂时无法使用。请将你的建议通过电子邮件发送至 [email protected]