Pierwsze kroki
Konfiguracja zajmuje kilka minut. Pierwsze skanowanie tylko odczytuje; pokazuje, co znalazło i dlaczego tak oceniło, i niczego nie rusza, dopóki nie potwierdzisz.
Pobieranie i instalacja
Pobierz plik .dmg ze strony Pobierz, otwórz go i przeciągnij Devbroom do folderu Aplikacje. Uruchom aplikację stamtąd.
Devbroom sam szuka nowych wersji: raz, 8 sekund po uruchomieniu, odczytuje publikowany przez nas plik latest.json. Gdy jest nowa wersja, pyta Cię; wybierz „Zainstaluj”, a przed instalacją zostanie sprawdzony jej podpis. Nic o Tobie nie jest wysyłane; szczegóły na stronie Prywatność.
Wybór folderów
Przy pierwszym uruchomieniu Devbroom pyta, gdzie są Twoje projekty. Wybierz foldery z kodem albo przeciągnij je do okna; później możesz je dodawać i usuwać w Ustawienia › Foldery.
Nie musisz dodawać folderów samych agentów. Foldery agentów w Twoim folderze domowym (~/.claude, ~/.codex i pozostałe) są częścią każdego skanowania.
Pełny dostęp do dysku
Jeśli folderu chronionego przez macOS, takiego jak Biurko, Dokumenty czy Pobrane, nie da się odczytać, Devbroom Ci o tym powie: „1 folder wymaga Pełnego dostępu do dysku”. Przycisk obok przeniesie Cię do Ustawienia systemowe › Prywatność i ochrona › Pełny dostęp do dysku, gdzie włączysz Devbroom. To uprawnienie jest opcjonalne: bez niego Devbroom po prostu nie odczyta tych folderów.
Pierwsze skanowanie
Skanowanie zaczyna się, gdy wybierzesz foldery. Tylko odczytuje: znajduje repozytoria git i worktree, foldery agentów, wyniki buildów i pamięci podręczne narzędzi, mierzy, ile miejsca każde z nich faktycznie zajmuje na dysku, i sprawdza, którzy agenci wciąż działają.
Jak czytać bańki
Na ekranie Dysk wszystko, co znaleziono, jest bańką tak dużą, jak zajmowane miejsce. Każda bańka dostaje werdykt i trafia do swojej grupy:
| Grupa | Co oznacza |
|---|---|
| READYGotowe | Wszystkie testy zaliczone. Od początku jest zaznaczone do wyczyszczenia. |
| REVIEWDo przejrzenia | Warto najpierw zajrzeć. Jest czyszczone tylko, jeśli wybierzesz „Uwzględnij mimo to”. |
| BLOCKEDZablokowane | W użyciu lub zawiera pracę. Nie da się zaznaczyć. |
| UNKNOWNNieznane | Za mało dowodów. Nie da się zaznaczyć, nigdy nie liczy się jako Gotowe. |
Kliknij bańkę, aby zobaczyć powody werdyktu: do którego agenta należy, czy jest w użyciu, czy zawiera niezapisaną pracę. Zajrzyj do środka pokazuje zawartość folderu. Wszystkie werdykty opisuje strona Werdykty.
Czyszczenie
- Naciśnij Wyczyść. Devbroom od razu ponownie sprawdza zaznaczone elementy: „Ponowne sprawdzanie 27 elementów”.
- Podgląd pokazuje, co się stanie: „Przenieś 27 elementów do Kosza”, łączny rozmiar i każdy element. Wszystko, co wybrałeś, a co nie przeszło sprawdzenia, jest wymienione w sekcji „Pominięte” wraz z powodem.
- Potwierdź, a elementy trafią do Kosza. Jeśli coś zmieniło się od skanowania, zostaje nietknięte, a Ty dowiesz się, dlaczego zostało pominięte.
- Miejsce przeniesione do Kosza zostaje na dysku, dopóki nie opróżnisz Kosza; Devbroom to mówi: „przeniesiono do Kosza · miejsce wróci po opróżnieniu Kosza”.
Jeśli zmienisz zdanie, Przywróć odstawi wszystko z powrotem; później nadal możesz przywracać elementy pojedynczo z Historii. Trwałe usunięcie to osobny wybór, potwierdzany przytrzymaniem przycisku.
Worktree nie trafiają do Kosza: są usuwane przez git, ich HEAD jest najpierw zapisywany w referencji do odzyskania, a gałąź zostaje.
Automatyczne porządki
W Ustawienia › Automatyczne porządki wybierasz, kiedy Devbroom ma skanować sam (wyłączone, codziennie lub co tydzień) i ile GB musi być gotowe, zanim da Ci znać. Automatyczne skanowania tylko odczytują.
Możesz też dodać reguły, na przykład „foldery buildów starsze niż 90 dni”. Domyślnie reguła najpierw Cię pyta. Wybierz „Rób samodzielnie”, a przeniesie wyłącznie elementy Gotowe i wyłącznie do Kosza; każdy z nich można przywrócić. Dopóki tego nie włączysz, Devbroom niczego nie zmienia bez Twojej zgody. Automatyczne porządki są w ramach Pro.
Sesje
Karta Sesje pokazuje historię sesji Twoich agentów według folderów: które działają, ile miejsca zajmują, które dotyczą folderów, których już nie ma, oraz szacowaną wartość zużytych tokenów według cennika API, także za ostatnie 30 dni. Te liczby są wyliczane wyłącznie na Twoim Macu.
- Wyszukiwanie: przeszukuje treść Twoich sesji. Logi są odczytywane w tym momencie, nic nie jest indeksowane; ciągi wyglądające na sekrety są w wynikach ukrywane.
- Archiwizacja rozmów: pakuje rozmowy Claude Code z danego folderu do archiwum, weryfikuje je, a potem przenosi oryginały do Kosza. Pamięć projektu zostaje na miejscu.
claude --resumenie otworzy zarchiwizowanych rozmów, dopóki nie zostaną przywrócone; przywrócisz je z Historii.
Użycie i koszt, wyszukiwanie i archiwizacja są w ramach Pro.
Pasek menu
Devbroom jest też na pasku menu: pokazuje, ile było gotowe po ostatnim skanowaniu, a podczas skanowania jego postęp; stamtąd możesz skanować ponownie lub zatrzymać skanowanie. Po zamknięciu okna Devbroom znika z Docka i działa dalej na pasku menu; aby go całkiem zakończyć, naciśnij ⌘Q.
Pro
Skanowanie, werdykty, czyszczenie, przywracanie, wiersz poleceń i MCP są bezpłatne. Automatyczne porządki, Analityka i narzędzia sesji są w Pro. Przez pierwsze 14 dni całe Pro jest włączone; bez karty, konta i adresu e-mail. Po zakończeniu okresu próbnego nic nie jest usuwane: reguły są wstrzymywane, a historia zostaje. Pro to jednorazowo $29 za 2 Maki; szczegóły na stronie Cennik.
Ostatnia aktualizacja: 7 października 2026