Wiersz poleceń

devbroom przenosi skanowanie z aplikacji do terminala: te same werdykty, te same powody. Skanowanie niczego nie usuwa, nie przenosi ani nie zmienia; czyszczenie to osobne polecenie.

Konfiguracja

devbroom jest w aplikacji; nie trzeba niczego doinstalowywać. Naciśnij „Podłącz devbroom” w Ustawienia › Agenci i integracje, a polecenie zostanie podlinkowane jako ~/.local/bin/devbroom. Jeśli aplikacji nie ma w folderze Aplikacje, najpierw ją tam przenieś, inaczej link przestanie działać. Potem otwórz nowy terminal i sprawdź wersję.

$ devbroom --versiondevbroom 0.1.0

Jeśli ~/.local/bin nie ma w PATH Twojej powłoki, uruchamiaj polecenie pełną ścieżką albo dodaj ten folder do PATH.

Użycie

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

Bez ścieżki skanowany jest bieżący folder. Możesz podać kilka ścieżek. Dane agentów w Twoim folderze domowym są częścią każdego skanowania.

$ devbroom                        # bieżący folder$ devbroom ~/projects ~/work      # kilka folderów$ devbroom ~/projects --details   # ze wszystkimi powodami$ devbroom ~/projects --all       # wszystkie, nie tylko największe

Opcje

Nieznana opcja jest błędem i nic nie zostaje przeskanowane.

Czyszczenie

devbroom clean skanuje, tworzy świeży plan z tego, co jest Gotowe, pokazuje plan i dopiero po Twojej zgodzie przenosi te foldery do Kosza. To, co zrobił, pojawia się w Historii aplikacji; jeśli w aplikacji trwa już czyszczenie, nie czeka, tylko kończy działanie.

$ devbroom clean ~/projects --dry-run   # tylko pokaż$ devbroom clean ~/projects             # pokaż, zapytaj, przenieś do Kosza

Bez ścieżki używa folderów wybranych w aplikacji albo bieżącego folderu, jeśli aplikacja nigdy nie była skonfigurowana. clean czyści tylko foldery buildów, foldery robocze agentów i pamięci podręczne; worktree i dane agentów czyści się w aplikacji.

Gdy nie ma terminala, w którym mógłby zapytać, albo podano --yes, jest surowszy: elementy, które są Gotowe wyłącznie dzięki własnemu .devbroom.toml projektu, nie trafiają do planu, bo ten plik mógł napisać agent. Bez terminala i bez --yes nic się nie zmienia.

Status

devbroom status pokazuje ostatnie skanowanie z aplikacji bez ponownego skanowania: ile jest gotowe do wyczyszczenia, ile minut temu skanowano i największe elementy Gotowe. --json zwraca to samo jako JSON. Jeśli aplikacja jeszcze nie skanowała, zwraca błąd.

MCP dla agentów

devbroom mcp to serwer MCP. Claude Code, Codex czy Cursor mogą odczytać ostatnie skanowanie, zapytać, dlaczego folder jest Gotowy albo Zablokowany, i poprosić Cię o czyszczenie; prośba trafia do Ciebie w aplikacji, a sam serwer nigdy niczego nie czyści. Konfigurację opisuje strona Integracje.

Jak czytać wynik

Raport jest po angielsku i ma cztery części. Każdy wiersz zaczyna się od werdyktu elementu.

$ 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

Agenci na tym Macu: wersja, zajmowane miejsce, liczba sesji, ile z nich dotyczy folderów, których już nie ma, i ile działa.

Cleanup potential

Łączny rozmiar i liczba elementów dla każdego werdyktu.

Worktrees

Sugerowana akcja dla każdego worktree (remove, prune, repair) i jej werdykt.

Largest items

Największe elementy wraz z powodami. --all pokazuje wszystkie.

Werdykty

Wiersz poleceń używa czterech werdyktów z aplikacji, zapisanych po angielsku wielkimi literami.

Wynik JSON

--json zapisuje cały raport; nadaje się do skryptów i ciągłej integracji. Format jest wersjonowany polem schema_version, obecnie 1. Gdy wybrano JSON, wiersz postępu nie jest wypisywany.

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

Zgodność

devbroom compat pokazuje, które wersje agentów Devbroom przetestował, a które są zainstalowane na Twoim Macu.

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

Jeśli Twoja wersja jest poza przetestowanym zakresem, ale pliki agenta mają oczekiwany format, Devbroom działa i oznacza ją jako „jeszcze nieprzetestowana”. Jeśli format się nie zgadza, dane tego agenta są tylko odczytywane i nic z nich nie liczy się jako gotowe do wyczyszczenia.

Kody wyjścia

Ctrl-C zatrzymuje skanowanie; drugie Ctrl-C kończy działanie natychmiast.

Zmienne środowiskowe

Ostatnia aktualizacja: 7 października 2026