Dòng lệnh

devbroom đưa việc quét của ứng dụng vào terminal: cùng kết luận, cùng lý do. Quét không xóa, không di chuyển, không thay đổi gì; dọn dẹp là một lệnh riêng.

Dòng lệnh là miễn phí. Quét chỉ đọc. devbroom clean làm đúng việc của nút Dọn dẹp trong ứng dụng: hiển thị trước những gì Sẵn sàng, hỏi, rồi chuyển vào Thùng rác. Các mục bảo vệ bạn đặt trong ứng dụng cũng áp dụng ở đây.

Thiết lập

devbroom nằm sẵn trong ứng dụng; không cần cài thêm gì. Nhấn “Liên kết devbroom” trong Cài đặt › Agent và tích hợp, lệnh sẽ được liên kết thành ~/.local/bin/devbroom. Nếu ứng dụng không nằm trong thư mục Ứng dụng, hãy chuyển nó vào đó trước, nếu không liên kết sẽ bị hỏng. Sau đó mở một terminal mới và kiểm tra phiên bản.

Terminal

$ devbroom --versiondevbroom 0.1.0

Nếu ~/.local/bin không nằm trong PATH của shell, hãy chạy lệnh bằng đường dẫn đầy đủ hoặc thêm thư mục đó vào PATH.

Cách dùng

devbroom [scan] [PATH...] [tùy chọn]devbroom clean [PATH...] [--dry-run] [--delete] [--include-review PATH]... [--yes] [--json]devbroom status [--json]devbroom mcpdevbroom compat

Nếu không có đường dẫn, thư mục bạn đang ở sẽ được quét. Bạn có thể đưa vào nhiều đường dẫn. Dữ liệu của các agent trong thư mục chính của bạn luôn có trong mỗi lần quét.

Ví dụ

$ devbroom                        # thư mục bạn đang ở$ devbroom ~/projects ~/work      # nhiều thư mục$ devbroom ~/projects --details   # kèm mọi lý do$ devbroom ~/projects --all       # tất cả, không chỉ những mục lớn nhất

Tùy chọn

Tùy chọn	Chức năng
`-d, --details`	Hiển thị mọi lý do đằng sau từng kết luận.
`-a, --all`	Liệt kê mọi mục tìm được, không chỉ những mục lớn nhất.
`--json`	Xuất toàn bộ báo cáo dưới dạng JSON.
`--no-color`	Tắt màu. Khi đặt `NO_COLOR`, màu cũng không được dùng.
`-h, --help`	Hiển thị trợ giúp.
`-V, --version`	Hiển thị phiên bản.
`--`	Coi mọi thứ phía sau là đường dẫn: `devbroom -- -odd-folder`

Tùy chọn không xác định là lỗi, và không có gì được quét.

Dọn dẹp

devbroom clean quét, lập một kế hoạch mới từ những gì Sẵn sàng, hiển thị kế hoạch, và chỉ sau khi bạn đồng ý mới chuyển các thư mục đó vào Thùng rác. Những gì nó làm sẽ xuất hiện trong Lịch sử của ứng dụng; nếu ứng dụng đang dọn dẹp, nó không chờ mà thoát luôn.

Terminal

$ devbroom clean ~/projects --dry-run   # chỉ hiển thị$ devbroom clean ~/projects             # hiển thị, hỏi, chuyển vào Thùng rác

Tùy chọn	Chức năng
`-n, --dry-run`	Hiển thị kế hoạch và không thay đổi gì.
`--delete`	Xóa vĩnh viễn thay vì chuyển vào Thùng rác. Không dùng được nếu tổ chức của bạn đã tắt xóa vĩnh viễn.
`--include-review PATH`	Thêm một mục Cần xem vào kế hoạch; tương ứng với “Vẫn đưa vào” trong ứng dụng. Yêu cầu xác nhận trong terminal và không dùng chung được với `--yes`. Có thể dùng nhiều lần.
`-y, --yes`	Dọn mà không hỏi.
`--json`	Xuất kế hoạch và kết quả dưới dạng JSON.

Nếu không có đường dẫn, nó dùng các thư mục bạn đã chọn trong ứng dụng, hoặc thư mục bạn đang ở nếu ứng dụng chưa từng được thiết lập. clean chỉ dọn thư mục build, thư mục tạm của agent và cache; worktree và dữ liệu agent được dọn trong ứng dụng.

Khi không có terminal để hỏi, hoặc khi có --yes, nó nghiêm ngặt hơn: các mục chỉ Sẵn sàng nhờ tệp .devbroom.toml của chính dự án sẽ bị loại khỏi kế hoạch, vì một agent có thể đã viết tệp đó. Không có terminal và không có --yes thì không có gì thay đổi.

Trạng thái

devbroom status hiển thị lần quét gần nhất của ứng dụng mà không quét lại: bao nhiêu sẵn sàng để dọn, đã quét cách đây bao nhiêu phút và các mục Sẵn sàng lớn nhất. --json trả về cùng nội dung dưới dạng JSON. Nếu ứng dụng chưa quét lần nào, lệnh báo lỗi.

MCP cho agent

devbroom mcp là một máy chủ MCP. Claude Code, Codex hoặc Cursor có thể đọc lần quét gần nhất, hỏi vì sao một thư mục Sẵn sàng hay Bị chặn, và nhờ bạn dọn; yêu cầu đến với bạn trong ứng dụng, và nó không bao giờ tự dọn gì. Cách thiết lập ở trang Tích hợp.

Đọc kết quả

Báo cáo được viết bằng tiếng Anh và có bốn phần. Mỗi dòng bắt đầu bằng kết luận của mục đó.

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: Các agent trên máy Mac này: phiên bản, dung lượng chiếm, số phiên, bao nhiêu phiên thuộc thư mục không còn tồn tại và bao nhiêu phiên đang chạy.
Cleanup potential: Tổng dung lượng và số mục của từng kết luận.
Worktrees: Thao tác đề xuất cho từng worktree (remove, prune, repair) và kết luận của nó.
Largest items: Các mục lớn nhất, kèm lý do. --all hiển thị tất cả.

Kết luận

Dòng lệnh dùng bốn kết luận của ứng dụng, viết bằng chữ in hoa (tiếng Anh).

Trong kết quả	Ý nghĩa
READYSẵn sàng	Đã qua mọi kiểm tra cho thao tác này.
REVIEWCần xem	Một rủi ro đã biết, hoặc một quyết định chỉ bạn mới đưa ra được; ví dụ một tệp `.env` bị bỏ qua.
BLOCKEDBị chặn	Đang dùng, được bảo vệ, hoặc còn chứa công việc mà git sẽ từ chối bỏ đi.
UNKNOWNKhông rõ	Chưa đủ bằng chứng. Không bao giờ tính là Sẵn sàng.

Đầu ra JSON

--json xuất toàn bộ báo cáo; phù hợp với script và tích hợp liên tục (CI). Định dạng được đánh phiên bản bằng trường schema_version, hiện là 1. Khi yêu cầu JSON, không có dòng tiến độ nào được in ra.

Terminal

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

Tương thích

devbroom compat cho biết Devbroom đã kiểm thử những phiên bản agent nào và phiên bản nào đang được cài trên máy Mac của bạn.

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

Nếu phiên bản của bạn nằm ngoài khoảng đã kiểm thử nhưng tệp của agent đúng định dạng mong đợi, Devbroom vẫn hoạt động và hiển thị là “chưa kiểm thử”. Nếu định dạng không khớp, dữ liệu của agent đó chỉ được đọc; không phần nào được tính là sẵn sàng để dọn.

Mã thoát

Mã	Ý nghĩa
`0`	Hoàn tất.
`1`	Thất bại.
`2`	Dùng sai: tùy chọn không xác định hoặc đường dẫn không phải thư mục.
`3`	`clean`: chưa xác nhận, không có gì thay đổi.
`4`	`clean`: hoàn tất một phần.
`5`	`clean`: đang có một lần dọn dẹp khác chạy.
`6`	`clean`: chính sách của tổ chức bạn không cho phép.
`130`	Đã hủy (Ctrl-C).

Ctrl-C dừng quét; nhấn Ctrl-C lần thứ hai sẽ thoát ngay.

Biến môi trường

Biến	Tác dụng
`NO_COLOR`	Khi được đặt, kết quả không có màu.
`CLAUDE_CONFIG_DIR`	Nếu thư mục cài đặt của Claude Code nằm ở nơi khác `~/.claude`, Devbroom đọc từ đó.
`CLAUDE_CODE_TMPDIR`	Nếu bạn đã chuyển thư mục tạm của Claude Code, Devbroom đọc từ đó.
`CODEX_HOME`	Nếu thư mục của Codex nằm ở nơi khác `~/.codex`, Devbroom đọc từ đó.
`CURSOR_CONFIG_DIR`	Nếu thư mục của Cursor nằm ở nơi khác `~/.cursor`, Devbroom đọc từ đó.
`XDG_DATA_HOME`, `XDG_CACHE_HOME`, `OPENCODE_DB`	Nếu dữ liệu và cơ sở dữ liệu của OpenCode nằm ở nơi khác, Devbroom đọc từ đó.

TrướcNguyên tắc TiếpTích hợp

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