命令行

devbroom 把应用的扫描带到终端：同样的判定，同样的理由。扫描不删除、不移动、不改动任何东西；清理是另一个单独的命令。

命令行免费。扫描只读取。devbroom clean 做的事和应用的“清理”按钮一样：先显示可清理的内容，询问后再移到废纸篓。你在应用中设置的保护在这里同样适用。

安装

devbroom 就在应用里面，无需额外安装。在“设置 › 智能体与集成”中按下“链接 devbroom”，命令就会被链接为 ~/.local/bin/devbroom。如果应用不在“应用程序”文件夹中，请先把它移过去，否则链接会失效。然后打开一个新的终端，检查版本。

终端

$ devbroom --versiondevbroom 0.1.0

如果 ~/.local/bin 不在你 shell 的 PATH 中，请用完整路径运行命令，或者把该文件夹加入 PATH。

用法

devbroom [scan] [PATH...] [options]devbroom clean [PATH...] [--dry-run] [--delete] [--include-review PATH]... [--yes] [--json]devbroom status [--json]devbroom mcpdevbroom compat

不指定路径时，扫描当前所在的文件夹。你可以指定多个路径。主文件夹中智能体的数据每次扫描都会包含。

示例

$ devbroom                        # 当前所在的文件夹$ devbroom ~/projects ~/work      # 多个文件夹$ devbroom ~/projects --details   # 附带每条理由$ devbroom ~/projects --all       # 全部列出，而不只是最大的

选项

选项	作用
`-d, --details`	显示每个判定背后的每条理由。
`-a, --all`	列出找到的每一项，而不只是最大的。
`--json`	以 JSON 输出完整报告。
`--no-color`	关闭颜色。设置了 `NO_COLOR` 时也不使用颜色。
`-h, --help`	显示帮助。
`-V, --version`	显示版本。
`--`	把其后的所有内容都当作路径：`devbroom -- -odd-folder`

未知的选项会报错，并且不会扫描任何东西。

清理

devbroom clean 会扫描，根据可清理的内容生成新的计划，显示计划，并且只有在你同意后才把这些文件夹移到废纸篓。它做过的事会出现在应用的“历史记录”中；如果应用中已有清理正在进行，它不会等待，而是直接退出。

终端

$ devbroom clean ~/projects --dry-run   # 只显示$ devbroom clean ~/projects             # 显示、询问、移到废纸篓

选项	作用
`-n, --dry-run`	显示计划，不改动任何东西。
`--delete`	永久删除，而不是移到废纸篓。如果你的组织关闭了永久删除，则不可用。
`--include-review PATH`	把一个需查看的项目加入计划；相当于应用中的“仍然加入”。会在终端中请求确认，不能与 `--yes` 一起使用。可以多次指定。
`-y, --yes`	不经询问直接清理。
`--json`	以 JSON 输出计划和结果。

不指定路径时，它使用你在应用中选择的文件夹；如果从未设置过应用，则使用当前所在的文件夹。clean 只清理构建文件夹、智能体的临时文件夹和缓存；worktree 和智能体数据在应用中清理。

当没有可供询问的终端，或指定了 --yes 时，它会更严格：仅因项目自己的 .devbroom.toml 而被判为可清理的项目不会进入计划，因为这个文件可能是智能体写的。既没有终端也没有 --yes 时，什么都不会改变。

状态

devbroom status 显示应用的上次扫描，不会重新扫描：有多少可清理、几分钟前扫描的，以及最大的可清理项目。--json 以 JSON 给出同样的内容。如果应用还没有扫描过，会报错。

为智能体提供 MCP

devbroom mcp 是一个 MCP 服务器。Claude Code、Codex 或 Cursor 可以读取上次扫描，询问某个文件夹为什么是可清理或已锁定，并请你清理；请求会在应用中交给你，它从不自行清理任何东西。设置方法见集成页面。

读懂输出

报告以英文书写，分为四部分。每一行都以该项的判定开头。

devbroom ~/projects

$ devbroom ~/projectsDevbroom scan (read-only) ~/projects in 22.4sAgent data on this Mac  Claude Code 2.1.288   37.8 GB  297 sessions, 2 running  Codex 0.159.2          746 MB  41 sessions  Orca 1.4.215           528 MBCleanup potential  READY    19.7 GB  56 items  every check passed  REVIEW   16.9 GB  39 items  worth a look before cleaning  BLOCKED  19.1 GB   5 items  in use or holding work

Agent data on this Mac: 这台 Mac 上的智能体：版本、占用空间、会话数、其中多少对应已不存在的文件夹，以及多少正在运行。
Cleanup potential: 每种判定的总大小和项目数。
Worktrees: 每个 worktree 的建议操作（remove、prune、repair）及其判定。
Largest items: 最大的项目及其理由。--all 会全部显示。

判定

命令行使用应用的四种判定，以大写形式书写。

输出中	含义
READY可清理	此操作的所有检查均已通过。
REVIEW需查看	已知的风险，或只有你才能做的决定；例如一个被忽略的 `.env` 文件。
BLOCKED已锁定	正在使用、受保护，或含有 git 会拒绝丢弃的工作。
UNKNOWN不确定	证据不足。永远不会算作可清理。

JSON 输出

--json 输出完整报告，适合脚本和持续集成。格式通过 schema_version 字段进行版本管理，当前为 1。请求 JSON 时不会输出进度行。

终端

$ devbroom ~/projects --json > report.json$ head -3 report.json{  "schema_version": 1,  …

兼容性

devbroom compat 显示 Devbroom 测试过哪些智能体版本，以及你的 Mac 上安装了哪些版本。

devbroom compat

Claude Code  tested: 2.1.0 to 2.1.292     here: 2.1.288 · verifiedCodex        tested: 0.115.0 to 0.159.2   here: 0.159.2 · verifiedCursor       tested: none yet             here: not on this MacOpenCode     tested: none yet             here: not on this MacOrca         tested: 1.4.0 to 1.4.221     here: 1.4.215 · verified

如果你的版本超出测试范围，但智能体的文件符合预期格式，Devbroom 仍可正常使用，并显示为“尚未测试”。如果格式不符，该智能体的数据只读取；其中任何内容都不算可清理。

退出码

代码	含义
`0`	完成。
`1`	失败。
`2`	用法错误：未知的选项，或路径不是文件夹。
`3`	`clean`：未确认，没有改动任何东西。
`4`	`clean`：部分完成。
`5`	`clean`：另一个清理正在进行。
`6`	`clean`：你所在组织的策略不允许。
`130`	已取消（Ctrl-C）。

Ctrl-C 会停止扫描；再按一次 Ctrl-C 立即退出。

环境变量

变量	作用
`NO_COLOR`	设置后，输出不带颜色。
`CLAUDE_CONFIG_DIR`	如果 Claude Code 的设置文件夹不在 `~/.claude`，就从这里读取。
`CLAUDE_CODE_TMPDIR`	如果你移动了 Claude Code 的临时文件夹，就从这里读取。
`CODEX_HOME`	如果 Codex 的文件夹不在 `~/.codex`，就从这里读取。
`CURSOR_CONFIG_DIR`	如果 Cursor 的文件夹不在 `~/.cursor`，就从这里读取。
`XDG_DATA_HOME`, `XDG_CACHE_HOME`, `OPENCODE_DB`	如果 OpenCode 的数据和数据库在别处，就从这些位置读取。

最后更新： 2026年10月7日