Komut satırı

devbroom, uygulamanın taramasını terminale getirir: aynı kararlar, aynı gerekçeler. Tarama hiçbir şeyi silmez, taşımaz, değiştirmez; temizlemek ayrı bir komuttur.

Kurulum

devbroom uygulamanın içinde gelir; ayrıca kurmanız gerekmez. Ayarlar › Ajanlar ve entegrasyonlar'da “devbroom'u bağla”ya basın; komut ~/.local/bin/devbroom olarak bağlanır. Uygulama Uygulamalar klasöründe değilse önce oraya taşıyın, yoksa bağlantı bozulur. Sonra yeni bir terminal açıp sürümü görerek doğrulayın.

$ devbroom --versiondevbroom 0.1.0

~/.local/bin kabuğunuzun PATH'inde değilse komutu tam yoluyla çalıştırın ya da bu klasörü PATH'e ekleyin.

Kullanım

devbroom [scan] [YOL...] [seçenekler]devbroom clean [YOL...] [--dry-run] [--delete] [--include-review YOL]... [--yes] [--json]devbroom status [--json]devbroom mcpdevbroom compat

Yol vermezseniz bulunduğunuz klasör taranır. Birden çok yol verebilirsiniz. Ajanların ana klasörünüzdeki verileri her taramaya dahildir.

$ devbroom                        # bulunduğunuz klasör$ devbroom ~/projects ~/work      # birden çok klasör$ devbroom ~/projects --details   # her gerekçesiyle$ devbroom ~/projects --all       # en büyükler değil, hepsi

Seçenekler

Tanınmayan bir seçenek hata verir ve hiçbir şey taranmaz.

Temizlik

devbroom clean tarar, Hazır olanlardan yeni bir plan yapar, planı gösterir ve ancak onayınızdan sonra o klasörleri Çöp Sepeti'ne taşır. Yaptıkları uygulamanın Geçmiş'inde görünür; uygulamada bir temizlik sürüyorsa beklemez, çıkar.

$ devbroom clean ~/projects --dry-run   # yalnızca göster$ devbroom clean ~/projects             # göster, sor, Çöp Sepeti'ne taşı

Yol vermezseniz uygulamada seçtiğiniz klasörler, uygulama hiç kurulmadıysa bulunduğunuz klasör kullanılır. clean yalnızca build klasörlerini, ajanların geçici klasörlerini ve önbellekleri temizler; worktree'ler ve ajan verileri uygulamada temizlenir.

Soracak bir terminal yoksa ya da --yes verildiyse daha katıdır: yalnızca bir projenin kendi .devbroom.toml dosyası yüzünden Hazır olanlar plana girmez, çünkü o dosyayı bir ajan da yazmış olabilir. Terminal yoksa ve --yes da yoksa hiçbir şey değişmez.

Durum

devbroom status uygulamanın son taramasını gösterir, yeniden taramaz: ne kadarının temizlenmeye hazır olduğunu, kaç dakika önce tarandığını ve en büyük Hazır öğeleri. --json aynısını JSON olarak verir. Uygulama henüz hiç taramadıysa hata verir.

Ajanlar için MCP

devbroom mcp bir MCP sunucusudur. Claude Code, Codex ya da Cursor son taramayı okuyabilir, bir klasörün neden Hazır ya da Kilitli olduğunu sorabilir ve sizden temizlik isteyebilir; istek uygulamada size gelir, kendi başına hiçbir şey temizlemez. Kurulumu Entegrasyonlar sayfasında.

Çıktıyı okumak

Rapor İngilizce yazılır ve dört bölümden oluşur. Her satırın başında öğenin kararı durur.

$ 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

Bu Mac'teki ajanlar: sürümü, kapladığı yer, oturum sayısı, kaçının artık olmayan klasörler için olduğu ve kaçının çalıştığı.

Cleanup potential

Her karar için toplam boyut ve öğe sayısı.

Worktrees

Her worktree için önerilen işlem (remove, prune, repair) ve kararı.

Largest items

En büyük öğeler, gerekçeleriyle. Hepsini görmek için --all.

Kararlar

Komut satırı, uygulamadaki dört kararın İngilizce adlarını kullanır.

JSON çıktısı

--json raporun tamamını yazar; betikler ve sürekli entegrasyon için uygundur. Biçim schema_version alanıyla sürümlenir, şu an 1. JSON istendiğinde ilerleme satırı yazılmaz.

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

Uyumluluk

devbroom compat, Devbroom'un hangi ajan sürümlerini denediğini ve sizin Mac'inizde hangilerinin kurulu olduğunu gösterir.

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

Sürümünüz denenen aralığın dışındaysa ama ajanın dosyaları beklenen biçimdeyse Devbroom çalışır ve bunu “henüz denenmedi” diye gösterir. Biçim tutmazsa o ajanın verileri yalnızca okunur; hiçbiri temizlenmeye hazır sayılmaz.

Çıkış kodları

Ctrl-C taramayı durdurur; ikinci Ctrl-C hemen çıkar.

Ortam değişkenleri

Son güncelleme: 7 Ekim 2026