Nguyên tắc

Nỗi lo thật sự không phải là tốn dung lượng, mà là mất công việc. Các nguyên tắc của Devbroom sinh ra vì điều đó, và không nguyên tắc nào là một tùy chọn cài đặt.

Quét chỉ đọc

Quét không thay đổi một tệp nào. Trừ khi bạn đặt một quy tắc thành “Tự làm” trong Bảo trì tự động, không có gì bị đụng tới nếu bạn chưa thấy trong bản xem trước và xác nhận.

Mỗi kết luận đều kèm lý do

Không mục nào là Sẵn sàng hay Bị chặn mà không có lý do. Lý do của mỗi kết luận được hiển thị cạnh mục đó, và trên dòng lệnh với --details.

Bị chặn và Không rõ không chọn được

Đây là giới hạn, không phải tùy chọn. Mục Cần xem chỉ được dọn với “Vẫn đưa vào”; trên dòng lệnh đó là --include-review, và nó yêu cầu xác nhận trong terminal.

Kiểm tra lại ngay trước khi xóa

Khi bạn nhấn Dọn dẹp, từng mục được kiểm tra lại với các tiến trình đang chạy ngay lúc đó. Mục nào có kết luận hoặc nội dung thay đổi kể từ lúc quét sẽ được giữ nguyên, và bạn được cho biết vì sao nó bị bỏ qua.

Thùng rác trước tiên

Mặc định là Thùng rác, và mục nào cũng trả lại đượ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; tổ chức của bạn có thể tắt nó. Dung lượng đã vào Thùng rác chưa được tính là đã giải phóng cho đến khi bạn dọn sạch Thùng rác.

Worktree: không bao giờ --force

• Worktree có thay đổi chưa commit, hoặc tệp chưa theo dõi hay đã stage, sẽ Bị chặn. Git không xóa nó nếu thiếu --force; Devbroom không bao giờ dùng --force.
• Tệp bị bỏ qua khiến nó thành Cần xem, vì git worktree remove sẽ xóa chúng mà không hỏi.
• Commit chưa push trên một nhánh vẫn còn khi worktree bị xóa; trên HEAD tách rời (detached HEAD) thì không. Vì vậy trước khi xóa, Devbroom lưu HEAD dưới refs/devbroom/removed; nếu không lưu được, nó không xóa.
• Chỉ có ba thao tác với worktree: xóa (remove), dọn bớt (prune) và sửa (repair).

Không đụng vào việc đang chạy

Nếu một phiên agent chạy trong thư mục đó hoặc thư mục cha, có tiến trình chạy từ đó, hoặc có tệp bên trong đang mở, mục đó sẽ Bị chặn. Với thư mục build, một phiên chạy trong thư mục cha khiến nó thành Cần xem.

Devbroom không bao giờ đụng tới tiến trình của một phiên agent đang chạy. Nó chỉ yêu cầu các tiến trình agent bỏ lại thoát khi bạn bảo, và chỉ sau khi kiểm tra lại; không bao giờ là tiến trình hệ thống hay tiến trình của người dùng khác.

Chỉ cái tên thì chưa đủ

Tên thư mục tự nó không phải là bằng chứng:

Thiếu dấu hiệu, thư mục vẫn là Cần xem. Nó cũng phải là thư mục git bỏ qua, và không chứa tệp nào git đang theo dõi.

Kích thước thật

Dung lượng dùng chung với thư mục khác qua hard link và APFS clone (như cách pnpm làm) không được tính. Con số bạn thấy là dung lượng thực sự được giải phóng khi xóa. Symbolic link không được đi theo, và các ổ được gắn (mount) sẽ bị bỏ qua.

Theo cách của chính agent

Cơ sở dữ liệu và thông tin xác thực của agent không bao giờ bị đụng tới. Khi agent có lệnh dọn dẹp riêng, việc dọn được làm hoặc hướng dẫn theo lệnh đó. Lịch sử của Claude Code hoặc được xóa bằng claude purge, hoặc được lưu trữ: hội thoại trước tiên được ghi vào một bản lưu trữ trong thư mục của Devbroom và được xác minh với bản gốc, rồi mới chuyển vào Thùng rác; bộ nhớ của dự án (memory/) ở nguyên chỗ, và bản lưu trữ có thể mở lại từ Lịch sử. Với phiên Codex, lệnh codex delete được hiển thị. Phiên của các agent khác chỉ được đọc.

Mọi thứ trên máy Mac của bạn

Không tài khoản, không telemetry; không gửi đi bất cứ thông tin gì về bạn. Ứng dụng kiểm tra cập nhật; nếu bạn nhập giấy phép Pro, nó kích hoạt một lần và lặng lẽ kiểm tra lại khoảng mỗi tháng một lần (chỉ khóa giấy phép và tên máy Mac). Không có giấy phép thì kiểm tra cập nhật là yêu cầu mạng duy nhất. Từ nhật ký phiên, nó chỉ lấy số token và tên model; tìm kiếm trong phiên đọc nhật ký ngay lúc đó, không giữ chỉ mục hay nhật ký nào, và ẩn các chuỗi trông giống bí mật trong đoạn trích. Chi tiết ở trang Quyền riêng tư.

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