整合

你的代理、捷徑和腳本都能取得 Devbroom 掌握的資訊。但它們都不會自行清理：代理的請求和連結會在 App 中交給你處理，devbroom clean 會先展示再詢問。

這些都在「設定 › 代理與整合」中。先用「連結 devbroom」把命令列工具連結為 ~/.local/bin/devbroom；MCP 和 Raycast 都會用到它。

為代理提供 MCP

devbroom mcp 是一個 MCP 伺服器，只與在這台 Mac 上啟動它的代理溝通。它從不對網路開放。它提供三個工具：

工具	作用
`devbroom_status`	讀取 App 的上次掃描；不會重新掃描。
`devbroom_check`	說明某個資料夾能否刪除及其原因。只接受你所選資料夾內的路徑。
`devbroom_request_cleanup`	附上理由，請求清理一個或多個資料夾。請求會在 App 中交給你。在你確認之前不會清理任何東西，確認後每一項還會再檢查一次。

命令列和 MCP 免費。把它加入你的代理：

Claude Code

$ claude mcp add --scope user devbroom -- ~/.local/bin/devbroom mcp

Codex · ~/.codex/config.toml

[mcp_servers.devbroom]command = "/Users/<user>/.local/bin/devbroom"args = ["mcp"]tool_timeout_sec = 180

Cursor · ~/.cursor/mcp.json

{ "mcpServers": { "devbroom": { "command": "/Users/<user>/.local/bin/devbroom", "args": ["mcp"] } } }

「設定 › 代理與整合」會用你 Mac 上的路徑填好這些行。

連結

Devbroom 認得三種連結。它們只會打開 App；清理要等你來做。

連結	作用
`devbroom://scan`	重新掃描。
`devbroom://clean`	為可清理的內容打開清理預覽。
`devbroom://open`	打開 App。加上 `?tab=storage`、`worktrees` 或 `sessions` 會前往對應的分頁。

其他任何連結都會被忽略。可以在「捷徑」中透過「打開 URL」動作使用它們，也可以從 Raycast 使用。

適合腳本

devbroom status --json 提供 App 的上次掃描：有多少可清理、何時掃描的，以及最大的可清理項目。它不會重新掃描。詳情請見命令列頁面。

分析

「分析」顯示代理資料如何成長以及 Devbroom 清理了什麼：這台 Mac 上的可用空間、今年清理了什麼以及仍在垃圾桶中的內容、最近 30 天的成長、什麼成長最快、各代理的成長，以及代理工作階段的 token 數和依 API 定價估計的費用。它根據每次掃描的摘要產生；掃描三次後會顯示圖表。所有資料都留在你的 Mac 上。分析包含在 Pro 中。

給組織使用

組織可以透過 com.devbroom.desktop 網域中的設定描述檔（MDM）設定 Devbroom 的部分行為。只有描述檔強制設定的值才有效；App 會把它們顯示為已鎖定，使用者無法更改。App 和命令列每次執行時都會重新讀取它們。

鍵	作用
`ProtectedPaths`	在使用者自己的保護之外，Devbroom 永遠不會建議清理的資料夾。
`ProtectedNames`	不論位於何處，都永遠不會建議清理的資料夾名稱。
`AllowPermanentDelete`	`false`：只能移到垃圾桶。App 和命令列中的永久刪除和清空垃圾桶都會關閉。
`AllowCommandLineClean`	`false`：`devbroom clean` 不會執行；掃描可以。
`AllowAgentRequests`	`false`：不接受代理透過 `devbroom mcp` 發出的清理請求；讀取仍可使用。

這是 Devbroom 的政策，而不是安全邊界：使用者仍然可以手動刪除檔案。如需團隊授權，請寫信給我們。

最後更新： 2026年10月7日