One Roof: agenci AI do kodu w jednej aplikacji na Maca

Sesje agentów, decyzje i powtarzalne kontrole w jednym miejscu.

gaurav8936.github.io
One Roof screenshot

Do czego służy One Roof? Proste wyjaśnienie

One Roof to bezpłatna aplikacja na Maca, która zbiera agentów AI do kodu w jednym miejscu. Claude Code, Codex, Gemini CLI, Kimi i Antigravity działają jako swoje rzeczywiste narzędzia terminalowe. Możesz też uruchamiać zwykłe powłoki. Aplikacja pokazuje pracę i pytania agentów, a ty podejmujesz decyzje.

Na stronie znajdziesz opis i pobieranie; właściwa praca odbywa się w zainstalowanej aplikacji. To rozwiązanie dla programistów dzielących planowanie, implementację i przegląd między agentów albo prowadzących kilka repozytoriów.

Jedna skrzynka zamiast szukania oczekujących pytań

Inbox zbiera prośby sesji i umieszcza blokujące sprawy na górze. Pokazuje opcje proponowane przez agenta. Odpowiadasz w skrzynce lub bezpośrednio w terminalu; aplikacja nie zatwierdza za ciebie.

Sesje mają stan, agenta, konto i folder. Usługa roofd utrzymuje ich działanie po zamknięciu aplikacji. Home podsumowuje nocne błędy i następne kroki. History przechowuje ważne zdarzenia oraz decyzje przez 30 dni, z możliwością wyszukiwania.

Pętle z kontrolą wyniku i ograniczeniami

W Loops ustawiasz repozytorium, agenta, cel, polecenie sprawdzające i limity. Przetestuj polecenie i obejrzyj podgląd pierwszego uruchomienia. Przykładowy cel to usunięcie błędu do momentu przejścia testów.

Najpierw wykonywana jest kontrola. Jeśli już kończy się powodzeniem, agent nie startuje. W przeciwnym razie pracuje w osobnym worktree Git, po czym kontrola jest ponawiana. Sukces albo limit czasu, rund lub powtarzających się błędów kończy pętlę. Wyniki czekają na twoją ocenę; pętla samodzielnie nie wykonuje push, merge ani wdrożenia.

Wbudowane pętle są początkowo wyłączone. Harmonogram przy zamkniętej aplikacji wymaga włączenia zaplanowanych uruchomień i niewyłączonego przez uśpienie Maca. Szczegóły opisuje instrukcja Loops.

Wymagania i pierwsza sesja

Potrzebujesz Apple silicon, macOS 14 lub nowszego, Git oraz co najmniej jednego zainstalowanego i uwierzytelnionego agenta CLI.

  1. Pobierz ZIP z Releases, rozpakuj i przenieś One Roof do Aplikacji.
  2. Dokończ konfigurację, zezwól na roofd i wybierz folder z repozytoriami.
  3. Naciśnij ⌘N, opisz zadanie i wybierz agenta oraz repozytorium.
  4. Uruchom przez ⌘Return. Pytania otworzysz skrótem ⌘I; przed przyjęciem wyniku sprawdź zmiany.

Jak rozumieć zużycie pamięci

Resources pokazuje pamięć i CPU sesji oraz drzew procesów, z wykresami z dziesięciu minut. Domyślne ostrzeżenie przy 1 GB i zakończenie przy 2 GB dotyczą procesu utrzymującego sesję. Nie ograniczają sumy pamięci wszystkich procesów potomnych. Konfiguracja może zmienić progi.

Bezpłatna aplikacja a koszty i uprawnienia agentów

Stan na 5 listopada 2026: aplikacja jest bezpłatna i dostępna na licencji MIT. Abonamenty agentów i wywołania API rozliczasz osobno. Rundy pętli, opcjonalne przeglądy i ewaluacje mogą zużywać twoje limity.

Nowa instalacja ustawia agentów w trybie Manual. Pozostałe tryby zależą od CLI, a własne argumenty mogą nadpisać ustawienia. Wskaż folder przeznaczony na kod: agenci mogą czytać jego zawartość. Lokalny interfejs nie gwarantuje działania wszystkich modeli bez sieci.

Dodatki i obecne granice produktu

Linear wymaga własnego klucza API. OpenCode i Goose mogą korzystać ze zdalnych modeli z twoimi poświadczeniami i limitami rezerwacji. Opcjonalny mały model lokalny pomaga tworzyć etykiety i uzasadnienia. Zestaw roof organizuje wspólne reguły: roof install --dry-run pokazuje plan instalacji, a roof doctor sprawdza konfigurację. Evals pozostaje wersją roboczą.

Częste pytania

Czy One Roof obejmuje bezpłatne użycie AI?

Bezpłatna jest aplikacja. Dostęp do modeli i kont agentów ma odrębne warunki.

Na jakich Macach działa One Roof?

Oficjalne wymagania to Apple silicon i macOS 14+. Nie potwierdzono GUI dla Windows/Linux ani wersji Intel.

Jakich agentów obsługuje?

Claude Code, Codex, Gemini CLI, Kimi, Antigravity i zwykłe powłoki. OpenCode i Goose wymagają dodatkowej konfiguracji.

Oficjalne materiały