Baris perintah

devbroom membawa pemindaian aplikasi ke terminal: status yang sama, alasan yang sama. Pemindaian tidak menghapus, memindahkan, atau mengubah apa pun; pembersihan adalah perintah terpisah.

Baris perintah gratis. Pemindaian hanya membaca. devbroom clean melakukan hal yang sama dengan tombol Bersihkan di aplikasi: menunjukkan dulu apa yang Siap, bertanya, lalu memindahkannya ke Tong Sampah. Perlindungan yang Anda atur di aplikasi juga berlaku di sini.

Penyiapan

devbroom ada di dalam aplikasi; tidak ada yang perlu dipasang tambahan. Tekan “Tautkan devbroom” di Pengaturan › Agen dan integrasi, dan perintahnya ditautkan sebagai ~/.local/bin/devbroom. Jika aplikasinya tidak ada di folder Aplikasi, pindahkan ke sana dulu, atau tautannya akan rusak. Lalu buka terminal baru dan periksa versinya.

Terminal

$ devbroom --versiondevbroom 0.1.0

Jika ~/.local/bin tidak ada di PATH shell Anda, jalankan perintahnya dengan jalur lengkap atau tambahkan folder itu ke PATH Anda.

Penggunaan

devbroom [scan] [PATH...] [options]devbroom clean [PATH...] [--dry-run] [--delete] [--include-review PATH]... [--yes] [--json]devbroom status [--json]devbroom mcpdevbroom compat

Tanpa jalur, folder tempat Anda berada yang dipindai. Anda bisa memberikan beberapa jalur. Data agen di folder rumah Anda selalu ikut dipindai.

Contoh

$ devbroom                        # folder tempat Anda berada$ devbroom ~/projects ~/work      # beberapa folder$ devbroom ~/projects --details   # dengan semua alasan$ devbroom ~/projects --all       # semuanya, bukan hanya yang terbesar

Opsi

Opsi	Fungsinya
`-d, --details`	Menampilkan semua alasan di balik setiap status.
`-a, --all`	Menampilkan semua item yang ditemukan, bukan hanya yang terbesar.
`--json`	Menulis seluruh laporan dalam format JSON.
`--no-color`	Mematikan warna. Warna juga tidak dipakai jika `NO_COLOR` diatur.
`-h, --help`	Menampilkan bantuan.
`-V, --version`	Menampilkan versi.
`--`	Menganggap semua yang ada setelahnya sebagai jalur: `devbroom -- -odd-folder`

Opsi yang tidak dikenal dianggap error, dan tidak ada yang dipindai.

Pembersihan

devbroom clean memindai, menyusun rencana baru dari apa yang Siap, menampilkan rencana itu, dan baru setelah Anda setuju memindahkan folder-folder itu ke Tong Sampah. Apa yang dilakukannya muncul di Riwayat aplikasi; jika pembersihan sedang berjalan di aplikasi, perintah ini tidak menunggu, tetapi langsung keluar.

Terminal

$ devbroom clean ~/projects --dry-run   # hanya tampilkan$ devbroom clean ~/projects             # tampilkan, tanya, pindahkan ke Tong Sampah

Opsi	Fungsinya
`-n, --dry-run`	Menampilkan rencana tanpa mengubah apa pun.
`--delete`	Menghapus permanen alih-alih memindahkan ke Tong Sampah. Tidak tersedia jika organisasi Anda mematikan penghapusan permanen.
`--include-review PATH`	Menambahkan item Tinjau ke rencana; sama dengan “Tetap sertakan” di aplikasi. Meminta konfirmasi di terminal dan tidak bisa dipakai bersama `--yes`. Bisa diberikan lebih dari sekali.
`-y, --yes`	Membersihkan tanpa bertanya.
`--json`	Menulis rencana dan hasilnya dalam format JSON.

Tanpa jalur, perintah ini memakai folder yang Anda pilih di aplikasi, atau folder tempat Anda berada jika aplikasi belum pernah disiapkan. clean hanya membersihkan folder build, folder sementara agen, dan cache; worktree dan data agen dibersihkan di aplikasi.

Jika tidak ada terminal untuk bertanya, atau --yes diberikan, aturannya lebih ketat: item yang Siap hanya karena .devbroom.toml milik proyek tidak dimasukkan ke rencana, karena file itu bisa saja ditulis oleh agen. Tanpa terminal dan tanpa --yes, tidak ada yang berubah.

Status

devbroom status menampilkan pemindaian terakhir aplikasi tanpa memindai ulang: berapa banyak yang siap dibersihkan, berapa menit yang lalu pemindaiannya, dan item Siap terbesar. --json memberikan hal yang sama dalam format JSON. Jika aplikasi belum pernah memindai, hasilnya error.

MCP untuk agen

devbroom mcp adalah server MCP. Claude Code, Codex, atau Cursor bisa membaca pemindaian terakhir, menanyakan mengapa sebuah folder Siap atau Terkunci, dan meminta Anda membersihkan; permintaan itu datang kepada Anda di aplikasi, dan server ini tidak pernah membersihkan apa pun sendiri. Penyiapannya ada di halaman Integrasi.

Membaca keluaran

Laporan ditulis dalam bahasa Inggris dan terdiri dari empat bagian. Setiap baris diawali status item.

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: Agen-agen di Mac ini: versi, ruang yang dipakai, jumlah sesi, berapa yang untuk folder yang sudah tidak ada, dan berapa yang sedang berjalan.
Cleanup potential: Total ukuran dan jumlah item untuk setiap status.
Worktrees: Tindakan yang disarankan untuk setiap worktree (remove, prune, repair) dan statusnya.
Largest items: Item terbesar, beserta alasannya. --all menampilkan semuanya.

Status

Baris perintah memakai empat status yang sama dengan aplikasi, ditulis dalam huruf kapital bahasa Inggris.

Di keluaran	Artinya
READYSiap	Lolos semua pemeriksaan untuk tindakan ini.
REVIEWTinjau	Risiko yang diketahui, atau keputusan yang hanya bisa Anda ambil; misalnya file `.env` yang diabaikan.
BLOCKEDTerkunci	Sedang dipakai, dilindungi, atau menyimpan pekerjaan yang tidak mau dibuang git.
UNKNOWNBelum jelas	Bukti belum cukup. Tidak pernah dianggap Siap.

Keluaran JSON

--json menulis seluruh laporan; cocok untuk skrip dan continuous integration. Formatnya diberi versi lewat kolom schema_version, saat ini 1. Tidak ada baris progres yang ditulis jika JSON diminta.

Terminal

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

Kompatibilitas

devbroom compat menunjukkan versi agen mana yang sudah diuji Devbroom dan mana yang terpasang di Mac Anda.

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

Jika versi Anda di luar rentang yang diuji tetapi file agennya dalam format yang diharapkan, Devbroom tetap berfungsi dan menampilkannya sebagai “belum diuji”. Jika formatnya tidak sesuai, data agen itu hanya dibaca; tidak ada yang dianggap siap dibersihkan.

Kode keluar

Kode	Artinya
`0`	Selesai.
`1`	Gagal.
`2`	Penggunaan salah: opsi yang tidak dikenal atau jalur yang bukan folder.
`3`	`clean`: tidak dikonfirmasi, tidak ada yang berubah.
`4`	`clean`: selesai sebagian.
`5`	`clean`: pembersihan lain sedang berjalan.
`6`	`clean`: kebijakan organisasi Anda tidak mengizinkannya.
`130`	Dibatalkan (Ctrl-C).

Ctrl-C menghentikan pemindaian; Ctrl-C kedua langsung keluar.

Variabel lingkungan

Variabel	Efeknya
`NO_COLOR`	Jika diatur, keluaran tidak berwarna.
`CLAUDE_CONFIG_DIR`	Jika folder pengaturan Claude Code ada di tempat selain `~/.claude`, dibaca dari sana.
`CLAUDE_CODE_TMPDIR`	Jika Anda memindahkan folder sementara Claude Code, dibaca dari sana.
`CODEX_HOME`	Jika folder Codex ada di tempat selain `~/.codex`, dibaca dari sana.
`CURSOR_CONFIG_DIR`	Jika folder Cursor ada di tempat selain `~/.cursor`, dibaca dari sana.
`XDG_DATA_HOME`, `XDG_CACHE_HOME`, `OPENCODE_DB`	Jika data dan basis data OpenCode ada di tempat lain, dibaca dari sana.

SebelumnyaAturan BerikutnyaIntegrasi

Terakhir diperbarui: 7 Oktober 2026