Bắt đầu
Thiết lập chỉ mất vài phút. Lần quét đầu tiên chỉ đọc; nó cho thấy những gì tìm được và vì sao đưa ra kết luận như vậy, và không đụng tới gì cho đến khi bạn xác nhận.
Tải xuống và cài đặt
Tải tệp .dmg từ trang Tải xuống, mở ra và kéo Devbroom vào thư mục Ứng dụng. Mở ứng dụng từ đó.
Devbroom tự tìm phiên bản mới: một lần, 8 giây sau khi khởi động, nó đọc tệp latest.json do chúng tôi công bố. Nếu có phiên bản mới, nó sẽ hỏi bạn; chọn “Cài đặt” thì chữ ký được kiểm tra trước khi cài. Không có gì về bạn được gửi đi; chi tiết ở trang Quyền riêng tư.
Chọn thư mục
Lần mở đầu tiên, Devbroom hỏi dự án của bạn nằm ở đâu. Chọn các thư mục chứa mã nguồn, hoặc kéo chúng vào; sau này bạn có thể thêm và bớt trong Cài đặt › Thư mục.
Bạn không cần thêm thư mục riêng của các agent. Thư mục agent trong thư mục chính của bạn (~/.claude, ~/.codex và các thư mục khác) luôn có trong mỗi lần quét.
Truy cập toàn bộ ổ đĩa
Nếu không đọc được một thư mục được macOS bảo vệ, như Màn hình nền, Tài liệu hay Tải về, Devbroom sẽ báo: “1 thư mục cần quyền Truy cập toàn bộ ổ đĩa.” Nút đi kèm đưa bạn tới Cài đặt hệ thống › Quyền riêng tư & Bảo mật › Truy cập toàn bộ ổ đĩa, nơi bạn bật Devbroom. Quyền này là tùy chọn: thiếu nó, Devbroom chỉ không đọc được các thư mục đó.
Lần quét đầu tiên
Quét bắt đầu ngay khi bạn chọn xong thư mục. Nó chỉ đọc: tìm repository git và worktree, thư mục của các agent, kết quả build và cache của công cụ phát triển, đo dung lượng thực tế mỗi thứ chiếm trên ổ đĩa, và kiểm tra agent nào vẫn đang chạy.
Đọc các bong bóng
Trên màn hình Dung lượng, mọi thứ tìm được là một bong bóng, to bằng dung lượng nó chiếm. Mỗi bong bóng nhận kết luận và vào nhóm của nó:
| Nhóm | Ý nghĩa |
|---|---|
| READYSẵn sàng | Đã qua mọi kiểm tra. Được chọn sẵn để dọn. |
| REVIEWCần xem | Nên xem qua trước. Chỉ được dọn nếu bạn chọn “Vẫn đưa vào”. |
| BLOCKEDBị chặn | Đang dùng hoặc còn chứa công việc. Không chọn được. |
| UNKNOWNKhông rõ | Chưa đủ bằng chứng. Không chọn được, không bao giờ tính là Sẵn sàng. |
Nhấp vào một bong bóng để xem lý do đằng sau kết luận: thuộc agent nào, có đang được dùng không, có chứa công việc chưa lưu không. Xem bên trong cho bạn thấy nội dung thư mục. Mọi kết luận có ở trang Kết luận.
Dọn dẹp
- Nhấn Dọn dẹp. Devbroom kiểm tra lại ngay các mục đã chọn: “Đang kiểm tra lại 27 mục.”
- Bản xem trước cho thấy điều sẽ xảy ra: “Chuyển 27 mục vào Thùng rác”, tổng dung lượng và từng mục. Mục nào bạn chọn mà không qua kiểm tra sẽ nằm trong “Bị loại ra” kèm lý do.
- Xác nhận, các mục sẽ vào Thùng rác. Nếu có gì thay đổi kể từ lúc quét, mục đó được giữ nguyên và bạn được cho biết vì sao nó bị bỏ qua.
- Dung lượng đã vào Thùng rác vẫn nằm trên ổ đĩa cho đến khi bạn dọn sạch Thùng rác; Devbroom nói rõ điều đó: “đã chuyển vào Thùng rác · dung lượng được trả lại khi bạn dọn sạch Thùng rác”.
Nếu đổi ý, Trả lại sẽ đưa mọi thứ về; sau này bạn vẫn có thể trả lại từng mục từ Lịch sử. Xóa vĩnh viễn là một lựa chọn riêng, xác nhận bằng cách nhấn giữ nút.
Worktree không vào Thùng rác: chúng được xóa bằng git, HEAD của chúng được lưu trước vào một ref khôi phục, và nhánh vẫn còn.
Bảo trì tự động
Trong Cài đặt › Bảo trì tự động, bạn chọn khi nào Devbroom tự quét (tắt, hằng ngày hoặc hằng tuần) và cần bao nhiêu GB sẵn sàng thì nó báo cho bạn. Các lần quét tự động chỉ đọc.
Bạn cũng có thể thêm quy tắc, chẳng hạn “thư mục build cũ hơn 90 ngày”. Theo mặc định, quy tắc sẽ hỏi bạn trước. Chọn “Tự làm” thì nó chỉ chuyển các mục Sẵn sàng, và chỉ vào Thùng rác; mục nào cũng trả lại được. Trừ khi bạn bật các tính năng này, Devbroom không thay đổi gì khi chưa có sự đồng ý của bạn. Bảo trì tự động có trong Pro.
Phiên
Tab Phiên hiển thị lịch sử phiên của các agent theo thư mục: phiên nào đang chạy, chiếm bao nhiêu dung lượng, phiên nào có thư mục không còn tồn tại, và giá trị ước tính của số token đã dùng theo giá niêm yết của API, kể cả trong 30 ngày qua. Các con số này chỉ được tính trên máy Mac của bạn.
- Tìm kiếm: tìm trong nội dung các phiên. Nhật ký được đọc ngay lúc đó, không lập chỉ mục; các chuỗi trông giống bí mật được ẩn trong kết quả.
- Lưu trữ hội thoại: đóng gói các hội thoại Claude Code của một thư mục vào một bản lưu trữ, xác minh nó, rồi chuyển bản gốc vào Thùng rác. Bộ nhớ của dự án ở nguyên chỗ.
claude --resumekhông mở được hội thoại đã lưu trữ cho đến khi chúng được mở lại; bạn có thể mở lại từ Lịch sử.
Mức dùng và chi phí, tìm kiếm và lưu trữ có trong Pro.
Thanh menu
Devbroom cũng có mặt trên thanh menu: nó cho biết có bao nhiêu sẵn sàng sau lần quét gần nhất và, khi đang quét, tiến độ quét; từ đó bạn có thể quét lại hoặc dừng quét. Đóng cửa sổ thì Devbroom rời Dock và tiếp tục chạy trên thanh menu; để thoát hẳn, nhấn ⌘Q.
Pro
Quét, kết luận, dọn dẹp, trả lại, dòng lệnh và MCP là miễn phí. Bảo trì tự động, Phân tích và các công cụ phiên nằm trong Pro. Trong 14 ngày đầu, toàn bộ Pro được bật; không cần thẻ, tài khoản hay email. Khi hết thời gian dùng thử, không có gì bị xóa: các quy tắc tạm dừng và lịch sử vẫn còn. Pro trả một lần $29 cho 2 máy Mac; chi tiết ở trang Bảng giá.
Cập nhật lần cuối: 7 tháng 10, 2026