Tích hợp

Agent, Phím tắt và script của bạn đều có thể truy cập những gì Devbroom biết. Không cái nào tự dọn: yêu cầu của agent và các liên kết đến với bạn trong ứng dụng, còn devbroom clean hiển thị trước rồi hỏi.

Tất cả nằm trong Cài đặt › Agent và tích hợp. Trước tiên, liên kết công cụ dòng lệnh thành ~/.local/bin/devbroom bằng “Liên kết devbroom”; MCP và Raycast dùng nó.

MCP cho agent

devbroom mcp là một máy chủ MCP giao tiếp với agent đã khởi động nó, trên máy Mac này. Nó không bao giờ mở ra mạng. Nó cung cấp ba công cụ:

Công cụ Chức năng
devbroom_status Đọc lần quét gần nhất của ứng dụng; không quét lại.
devbroom_check Cho biết một thư mục có thể xóa không và vì sao. Chỉ nhận đường dẫn nằm trong các thư mục bạn đã chọn.
devbroom_request_cleanup Yêu cầu dọn một hoặc nhiều thư mục, kèm lý do. Yêu cầu đến với bạn trong ứng dụng. Không gì được dọn cho đến khi bạn xác nhận, và từng mục được kiểm tra lại sau đó.

Dòng lệnh và MCP là miễn phí. Để thêm vào agent của bạn:

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"] } } }

Cài đặt › Agent và tích hợp điền sẵn các dòng này với đường dẫn trên máy Mac của bạn.

Liên kết

Devbroom nhận ba liên kết. Chúng chỉ mở ứng dụng; việc dọn dẹp chờ bạn.

Liên kết Chức năng
devbroom://scan Quét lại.
devbroom://clean Mở bản xem trước dọn dẹp cho những gì Sẵn sàng.
devbroom://open Mở ứng dụng. Với ?tab=storage, worktrees hoặc sessions, nó chuyển tới tab đó.

Mọi liên kết khác đều bị bỏ qua. Dùng chúng trong Phím tắt với tác vụ Mở URL, hoặc từ Raycast.

Cho script

devbroom status --json trả về lần quét gần nhất của ứng dụng: bao nhiêu đã sẵn sàng, quét lúc nào và các mục Sẵn sàng lớn nhất. Nó không quét lại. Chi tiết ở trang Dòng lệnh.

Phân tích

Phân tích cho thấy dữ liệu agent tăng thế nào và Devbroom đã dọn những gì: dung lượng trống trên máy Mac này, những gì đã dọn trong năm nay và những gì vẫn còn trong Thùng rác, mức tăng trong 30 ngày qua, thứ gì tăng nhanh nhất, mức tăng theo agent, và số token của các phiên agent cùng chi phí ước tính theo giá niêm yết của API. Phân tích được tạo từ bản tóm tắt của mỗi lần quét; biểu đồ xuất hiện sau ba lần quét. Tất cả ở lại trên máy Mac của bạn. Phân tích có trong Pro.

Cho tổ chức

Một tổ chức có thể thiết lập một số hành vi của Devbroom bằng hồ sơ cấu hình (MDM) trong miền com.devbroom.desktop. Chỉ các giá trị được hồ sơ áp đặt mới có hiệu lực; ứng dụng hiển thị chúng ở trạng thái khóa và người dùng không thể thay đổi. Ứng dụng và dòng lệnh đọc lại chúng mỗi lần chạy.

Khóa Chức năng
ProtectedPaths Các thư mục Devbroom không bao giờ đề xuất dọn, bổ sung cho các mục bảo vệ của chính người dùng.
ProtectedNames Các tên thư mục không bao giờ được đề xuất dọn, dù nằm ở đâu.
AllowPermanentDelete false: chỉ chuyển vào Thùng rác. Xóa vĩnh viễn và dọn sạch Thùng rác bị tắt trong ứng dụng và trên dòng lệnh.
AllowCommandLineClean false: devbroom clean không chạy; quét thì vẫn chạy.
AllowAgentRequests false: không chấp nhận yêu cầu dọn dẹp từ agent qua devbroom mcp; việc đọc vẫn hoạt động.

Đây là chính sách dành cho Devbroom, không phải ranh giới bảo mật: người dùng vẫn có thể tự xóa tệp bằng tay. Với giấy phép nhóm, hãy viết cho chúng tôi.

Cập nhật lần cuối: 7 tháng 10, 2026