Wiele katalogów, jeden projekt
dla każdego agenta AI, którego uruchamiasz
Gra w jednym folderze, a jej port na nowszą wersję silnika w innym. Aplikacja webowa i API, które wywołuje, w dwóch repozytoriach. Wspólna biblioteka obok aplikacji, które z niej korzystają. Twoi agenci potrzebują obu stron, a przeniesienie folderów pod jeden folder nadrzędny zepsułoby konfigurację, która działa.
Zamiast tego powiąż pozostałe foldery z projektem. Zostają tam, gdzie są, i zachowują własną kontrolę wersji. Każdy agent uruchomiony w projekcie je dostaje: przez --add-dir w Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code i Mistral Vibe, a w swojej instrukcji w przypadku pozostałych CLI. Zakładka Zmiany pozwala potem przejrzeć i scommitować każde repozytorium.
- /work/web-appFolder projektu · git
- /work/apiPowiązany folder · git
- /work/shared-libPowiązany folder · git
Jeden projekt, trzy repozytoria: każdy agent startuje w folderze projektu i dostaje dwa pozostałe w formie, którą rozumie jego CLI.
Agent startuje w jednym folderze i większość CLI go tam trzyma. Często może czytać dookoła, ale edycja poza katalogiem roboczym oznacza prośbę o uprawnienia, odmowę sandboxa albo flagę, o której trzeba pamiętać przy każdym uruchomieniu. To działa, dopóki praca nie obejmuje dwóch miejsc: aplikacji i jej API, gry i jej kopii na nowszym silniku, biblioteki i projektów, które z niej korzystają.
Typowe obejścia mają swoją cenę. Przeniesienie obu folderów pod jeden folder nadrzędny psuje ścieżki, skrypty i ustawienia edytora, które działały. Dowiązanie symboliczne myli niektóre narzędzia i ukrywa, gdzie naprawdę leżą pliki. Wpisywanie --add-dir przy każdym uruchomieniu działa aż do tego jednego razu, kiedy o nim zapomnisz.
Powiązane foldery to lista zapisana w projekcie. Dodajesz folder raz, w Ustawieniach projektu, Ogólne, Powiązane foldery. Od tej chwili każdy agent projektu, niezależnie od tego, czy uruchamiasz go z listy agentów, z ticketu w backlogu, czy z telefonu, dostaje te foldery, a każdy folder zachowuje własne repozytorium.
Co robią powiązane foldery
Lista w projekcie, odczytywana przy każdym uruchomieniu. Projekt bez powiązanych folderów działa dokładnie tak jak wcześniej.
Foldery zostają tam, gdzie są
Wybierz folder w systemowym oknie wyboru folderu. Nic nie jest przenoszone, kopiowane ani dowiązywane symbolicznie, a każdy folder zachowuje własne repozytorium, gałąź i historię. Do dziesięciu folderów na projekt.
Właściwa flaga dla każdego CLI
Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code i Mistral Vibe dostają każdy folder przez własną flagę --add-dir, zarówno gdy agent startuje od zera, jak i gdy wznawia sesję.
Wymienione w instrukcji agenta
Każdy agent, niezależnie od CLI, dostaje też krótki blok w swojej instrukcji: foldery, informację, że należą do projektu, i że git uruchamia się z wnętrza każdego z nich. CLI bez flagi docierają do nich pełną ścieżką, gdy pozwala na to ich sandbox.
Commituj każde repozytorium
W zakładce Zmiany selektor repozytorium pokazuje folder projektu i każdy powiązany folder, który jest repozytorium git. Wybierz jedno, żeby zobaczyć jego diff, a potem dodaj zmiany do stage, scommituj je i wypchnij.
Tak samo na telefonie
Agent uruchomiony z aplikacji mobilnej AgentsRoom dostaje te same flagi i tę samą instrukcję, bo to komputer przygotowuje uruchomienie. Telefon pokazuje powiązane foldery w menu projektu, a jego ekran Zmiany też oferuje powiązane repozytoria.
Sprawdzane przy starcie
Folder, którego brakuje na dysku, na przykład na odłączonym dysku zewnętrznym, zostaje na liście z ostrzeżeniem i jest pomijany przy starcie, z jedną linią w terminalu. Sam folder projektu i duplikaty są odrzucane.
Jak to działa
Cztery kroki, a dwa pierwsze robisz raz na projekt.
- 1
Otwórz ustawienia projektu
Ustawienia projektu, Ogólne, Powiązane foldery. Pole mówi, które CLI dostają foldery przez flagę, a jak docierają do nich pozostałe.
- 2
Dodaj folder
Dodaj folder otwiera systemowe okno wyboru folderu, a folder zapisuje się od razu. Krzyżyk obok usuwa go później z projektu: na dysku nic się nie zmienia.
- 3
Uruchom agenta
Uruchom dowolnego agenta projektu jak zwykle: z listy agentów, z ticketu w backlogu albo z telefonu. Startuje w folderze projektu i ma też powiązane foldery.
- 4
Przejrzyj i scommituj każde repozytorium
Otwórz zakładkę Zmiany i wybierz repozytorium: folder projektu albo powiązany folder. Przeczytaj jego diff, a potem dodaj zmiany do stage, scommituj je i wypchnij właśnie tam. Każdy folder zachowuje własną historię.
Claude Code i Codex już potrafią dodać katalog. Oto co się zmienia
Claude Code przyjmuje --add-dir przy starcie i /add-dir w trakcie sesji, a trwałą listę trzyma w additionalDirectories w swoich plikach ustawień. Dodany katalog dostaje dostęp do plików na tych samych zasadach uprawnień co katalog roboczy. Z katalogu przekazanego przez --add-dir lub /add-dir ładuje też skille, polecenia i subagentów, ale nie jego CLAUDE.md, chyba że ustawiono CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1; katalog wymieniony w pliku ustawień daje tylko dostęp do plików. Sprawdzone w dokumentacji Claude Code i na wersji 2.1.300 w październiku 2026.
Codex też ma --add-dir, które pozwala zapisywać w katalogu obok głównej przestrzeni roboczej, oraz writable_roots w sekcji sandbox_workspace_write w config.toml dla trwałej listy (codex-cli 0.162.1). GitHub Copilot CLI, Antigravity CLI, Kimi Code i Mistral Vibe mają każde własne --add-dir.
Sama flaga nie jest więc nowością. AgentsRoom dodaje listę zapisaną w projekcie i przekazywaną każdemu agentowi przy każdym uruchomieniu, w formie, jakiej oczekuje każde CLI (Claude Code potrzebuje flagi i folderu w jednym kawałku, jak w --add-dir=/work/api, inaczej opcja połyka następujący po niej prompt), tę samą instrukcję dla CLI bez flagi, uruchomienia z telefonu, które dostają te same foldery, i zakładkę Zmiany, która commituje każde repozytorium. AgentsRoom nie ustawia za Ciebie CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD.
Co warto wiedzieć
- Automatyczne commity po ukończeniu ticketu, jeden worktree na ticket i diffy kroków zespołu zostają przy folderze projektu. W powiązanym folderze przeglądasz i commitujesz ręcznie.
- Lista jest zapisywana osobno na każdym komputerze, bo ścieżka taka jak D:\Games\UE5 nic nie znaczy na innej maszynie. Dodaj foldery ponownie na swoich pozostałych komputerach.
- Agent uruchomiony na zdalnym serwerze przez SSH nie dostaje powiązanych folderów: to ścieżki na tym komputerze. Informuje o tym jedna linia w jego terminalu.
- OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin i Cursor nie mają flagi dla dodatkowego katalogu. Ich agenci znajdują foldery w swojej instrukcji i docierają do nich pełną ścieżką tylko wtedy, gdy pozwala na to ich własny sandbox.
- Telefon pokazuje listę, ale jej nie edytuje: folder wybiera się w oknie wyboru folderu na komputerze.
- Najwyżej dziesięć folderów na projekt, bo polecenie uruchomienia ma w Windows limit długości.
Najczęściej zadawane pytania
Jak dać Claude Code dostęp do wielu katalogów?
W samym Claude Code: --add-dir ze ścieżką przy starcie, /add-dir w trakcie sesji albo additionalDirectories w pliku ustawień dla trwałej listy. W AgentsRoom dodaj foldery raz jako powiązane foldery projektu (Ustawienia projektu, Ogólne, Powiązane foldery): każdy agent Claude Code w projekcie startuje wtedy z --add-dir dla każdego z nich, podobnie jak agenci pozostałych CLI, które mają tę flagę.
Czy Codex może pracować w wielu repozytoriach?
Tak. Codex startuje w jednej przestrzeni roboczej, --add-dir pozwala zapisywać w innym katalogu obok niej, a writable_roots w config.toml trzyma trwałą listę. AgentsRoom przekazuje --add-dir każdemu agentowi Codex w projekcie dla każdego powiązanego folderu, także gdy agent wznawia sesję, a jego instrukcja mówi mu, żeby uruchamiał git z wnętrza każdego repozytorium.
Czy jeden projekt może obejmować kilka repozytoriów git?
Tak. Projekt zachowuje swój główny folder, w którym startują agenci, i wiąże pozostałe repozytoria. Każde zachowuje własną kontrolę wersji. W zakładce Zmiany selektor repozytorium przełącza między folderem projektu a każdym powiązanym repozytorium, żeby przeczytać jego diff, scommitować je i wypchnąć.
Czy moje foldery są przenoszone, kopiowane albo dowiązywane symbolicznie?
Nie. AgentsRoom zapisuje tylko ich ścieżki i przekazuje je agentom przy starcie. Na dysku nic się nie zmienia, gdy dodajesz lub usuwasz powiązany folder.
Które CLI agentów dostają powiązane foldery?
Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code i Mistral Vibe dostają każdy folder przez własną flagę --add-dir. OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin i Cursor nie mają takiej flagi: znajdują foldery w swojej instrukcji i otwierają je pełną ścieżką, gdy pozwala na to ich sandbox.
Czy agent czyta CLAUDE.md powiązanego folderu?
Domyślnie nie. Claude Code ładuje skille, polecenia i subagentów z katalogu przekazanego przez --add-dir, ale jego CLAUDE.md tylko wtedy, gdy ustawiono CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1, a AgentsRoom nie ustawia tego za Ciebie. Każdy agent dostaje natomiast instrukcję: gdzie jest każdy powiązany folder, że należy do projektu i że zachowuje własną kontrolę wersji.
Czy worktree i automatyczny commit obejmują powiązane foldery?
Nie, zostają przy folderze projektu: jeden worktree na ticket, automatyczne commity po ukończeniu ticketu i diffy kroków zespołu. W powiązanym folderze przeglądaj i commituj ręcznie w zakładce Zmiany.
Czy powiązane foldery są dostępne na moich innych komputerach?
Nie. Lista jest zapisywana na komputerze, na którym ją utworzono, bo ścieżka folderu istnieje tylko tam. Agenci uruchomieni na zdalnym serwerze przez SSH też nie dostają tych folderów. Reszta projektu, czyli jego agenci, backlog i ustawienia, jak zwykle podąża za Twoim kontem.
Czy to działa w Windows i Linux?
Tak, w macOS, Windows i Linux. W Windows litery dysków i oba rodzaje ukośników są rozpoznawane, a każde --add-dir jest ujmowane w cudzysłów dla PowerShell.
Może Ci się też spodobać
Wieloprojektowo · Wieloagentowo · Równolegle
AgentsRoom uruchamia wielu agentów AI na Claude, Codex, GitHub Copilot CLI, Cursor i 10 innych CLI agentów równolegle w wielu projektach, wszystko w jednym oknie. Role oznaczone kolorami, status na żywo, liczniki per projekt, natywne powiadomienia na komputerze i telefonie. Wizualna alternatywa dla 12 zakładek terminala i chaosu sesji Claude Code rozsianych po iTerm2, Warp i tmux.
Git worktree
Daj każdemu agentowi AI lub ticketowi własny git worktree, gotowy do budowania (zależności zainstalowane, .env skopiowane), a potem przejrzyj go, scommituj i scal w jednym oknie.
Przegląd wg Agenta
Przeglądaj zmiany kodu każdego agenta AI osobno. AgentsRoom śledzi, który agent Claude Code zmodyfikował które pliki. Filtruj diffy wg agenta, przeglądaj indywidualnie, commituj wg agenta dla czystej historii git.
Multi-Provider
AgentsRoom obsługuje 14 dostawców AI do kodowania: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe, Kimi Code, Amp, oh-my-pi, Freebuff, Devin i Cursor. Przypisz innego dostawcę do każdego agenta, przełączaj dostawcę w trakcie rozmowy i zachowuj pełny kontekst dzięki automatycznemu handoffowi. Najlepsze multi-provider narzędzie do kodowania z AI.
Połączenia SSH
Zapisuj swoje połączenia SSH, otwieraj wbudowany terminal po SSH i uruchamiaj Claude Code, Codex lub Antigravity CLI bezpośrednio na zdalnym serwerze czy VPS. Uwierzytelnianie kluczem SSH lub hasłem, profile połączeń per projekt, bez osobnego klienta SSH.
Daj swoim agentom cały projekt
Pobierz AgentsRoom, otwórz główne repozytorium jako projekt i powiąż pozostałe w Ustawieniach projektu, Ogólne, Powiązane foldery.
Aplikacja towarzysząca: monitoruj agentów w podróży
Użyj Claude, Codex, Antigravity CLI lub innego dostawcy AI.
Wysyłaj bugi i prośby bezpośrednio do swojego publicznego backlogu.