Vários diretórios, um só projeto
para cada agente de IA que você inicia
Um jogo numa pasta e a adaptação dele para uma versão mais recente do motor em outra. Um app web e a API que ele chama, em dois repositórios. Uma biblioteca compartilhada ao lado dos apps que a usam. Seus agentes precisam dos dois lados, e juntar as pastas sob um mesmo diretório pai quebraria uma organização que funciona.
Em vez disso, vincule as outras pastas ao projeto. Elas ficam onde estão e mantêm o próprio controle de versão. Cada agente que você inicia no projeto as recebe: via --add-dir no Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code e Mistral Vibe, e no brief dele para as outras CLIs. Depois, a aba Alterações revisa e faz o commit de cada repositório.
- /work/web-appPasta do projeto · git
- /work/apiPasta vinculada · git
- /work/shared-libPasta vinculada · git
Um projeto, três repositórios: cada agente começa na pasta do projeto e recebe as outras duas, na forma que a CLI dele entende.
Um agente começa numa pasta, e a maioria das CLIs o mantém ali. Muitas vezes ele consegue ler ao redor, mas editar fora do diretório de trabalho significa um pedido de permissão, uma recusa do sandbox ou uma flag que você precisa lembrar a cada início. Isso se sustenta até o trabalho abranger dois lugares: o app e a API dele, um jogo e a cópia dele num motor mais recente, uma biblioteca e os projetos que a consomem.
As soluções de sempre têm um custo. Juntar as duas pastas sob um mesmo diretório pai quebra caminhos, scripts e configurações de editor que funcionavam. Um link simbólico confunde algumas ferramentas e esconde onde os arquivos realmente estão. Digitar --add-dir a cada início funciona até o dia em que você esquece.
As pastas vinculadas são uma lista guardada no projeto. Você adiciona uma pasta uma única vez, em Configurações do projeto, Geral, Pastas vinculadas. A partir daí, cada agente do projeto, seja iniciado pela lista de agentes, por um ticket do backlog ou pelo celular, recebe essas pastas, e cada pasta mantém o próprio repositório.
O que as pastas vinculadas fazem
Uma lista no projeto, lida a cada início. Um projeto sem pastas vinculadas funciona exatamente como antes.
As pastas ficam onde estão
Escolha uma pasta com o seletor de pastas do sistema. Nada é movido, copiado ou transformado em link simbólico, e cada pasta mantém o próprio repositório, branch e histórico. Até dez pastas por projeto.
A flag certa para cada CLI
Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code e Mistral Vibe recebem cada pasta pela própria flag --add-dir, tanto quando o agente começa do zero quanto quando retoma uma sessão.
Citadas no brief do agente
Cada agente, qualquer que seja a CLI, também recebe um bloco curto no brief: as pastas, que elas fazem parte do projeto e que o git roda de dentro de cada uma. As CLIs sem flag chegam até elas pelo caminho completo quando o sandbox delas permite.
Faça o commit de cada repositório
Na aba Alterações, um seletor de repositório lista a pasta do projeto e cada pasta vinculada que é um repositório git. Escolha um para ver o diff, depois colocá-lo em staging, fazer o commit e o push.
Igual no celular
Um agente iniciado pelo app mobile do AgentsRoom recebe as mesmas flags e o mesmo brief, porque é o computador que prepara o início. O celular mostra as pastas vinculadas no menu do projeto, e a tela Alterações dele também oferece os repositórios vinculados.
Verificadas ao iniciar
Uma pasta que sumiu do disco, num disco desconectado por exemplo, continua na lista com um aviso e é ignorada ao iniciar, com uma linha no terminal. A própria pasta do projeto e as duplicatas são recusadas.
Como funciona
Quatro passos, e os dois primeiros acontecem uma vez por projeto.
- 1
Abra as configurações do projeto
Configurações do projeto, Geral, Pastas vinculadas. O campo diz quais CLIs recebem as pastas por uma flag e como as outras chegam até elas.
- 2
Adicione uma pasta
Adicionar uma pasta abre o seletor de pastas do sistema, e a pasta é salva na hora. O X ao lado dela a remove do projeto depois: nada muda no disco.
- 3
Inicie um agente
Inicie qualquer agente do projeto como de costume: pela lista de agentes, por um ticket do backlog ou pelo celular. Ele começa na pasta do projeto e também tem as pastas vinculadas.
- 4
Revise e faça o commit de cada repositório
Abra a aba Alterações e escolha um repositório: a pasta do projeto ou uma pasta vinculada. Leia o diff, depois coloque em staging, faça o commit e o push ali mesmo. Cada pasta mantém o próprio histórico.
Claude Code e Codex já sabem adicionar um diretório. Veja o que muda
O Claude Code aceita --add-dir ao iniciar e /add-dir durante uma sessão, e guarda uma lista permanente em additionalDirectories dos seus arquivos de configuração. Um diretório adicionado ganha acesso aos arquivos com as mesmas regras de permissão do diretório de trabalho. De um diretório passado com --add-dir ou /add-dir ele também carrega as skills, os comandos e os subagents, mas não o CLAUDE.md dele, a menos que CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 esteja definido; um diretório listado num arquivo de configuração só dá acesso aos arquivos. Verificado na documentação do Claude Code e na versão 2.1.300 em outubro de 2026.
O Codex também tem --add-dir, que torna um diretório gravável ao lado do espaço de trabalho principal, e writable_roots em sandbox_workspace_write no config.toml para uma lista permanente (codex-cli 0.162.1). GitHub Copilot CLI, Antigravity CLI, Kimi Code e Mistral Vibe têm cada um o próprio --add-dir.
Então a flag não é a novidade. O que o AgentsRoom acrescenta é a lista guardada no projeto e passada a cada agente a cada início, na forma que cada CLI espera (o Claude Code precisa da flag e da pasta numa peça só, como em --add-dir=/work/api, senão a opção engole o prompt que vem depois dela), o mesmo brief para as CLIs que não têm flag, inícios pelo celular que recebem as mesmas pastas e uma aba Alterações que faz o commit de cada repositório. O AgentsRoom não define CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD por você.
O que você precisa saber
- Os commits automáticos quando um ticket é concluído, o worktree por ticket e os diffs das etapas de equipe ficam na pasta do projeto. Numa pasta vinculada, você revisa e faz o commit manualmente.
- A lista é salva em cada computador, porque um caminho como D:\Games\UE5 não significa nada em outra máquina. Adicione as pastas de novo nos seus outros computadores.
- Um agente iniciado num servidor remoto via SSH não recebe as pastas vinculadas: elas são caminhos deste computador. Uma linha no terminal dele avisa isso.
- OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin e Cursor não têm flag para um diretório extra. Os agentes deles encontram as pastas no brief e só chegam até elas pelo caminho completo quando o próprio sandbox permite.
- O celular mostra a lista, mas não a edita: uma pasta é escolhida com o seletor de pastas do computador.
- No máximo dez pastas por projeto, porque um comando de início tem um limite de tamanho no Windows.
Perguntas frequentes
Como dar ao Claude Code acesso a vários diretórios?
No próprio Claude Code: --add-dir seguido de um caminho ao iniciá-lo, /add-dir durante uma sessão ou additionalDirectories num arquivo de configuração para uma lista permanente. No AgentsRoom, adicione as pastas uma única vez como pastas vinculadas do projeto (Configurações do projeto, Geral, Pastas vinculadas): cada agente Claude Code do projeto passa a iniciar com um --add-dir para cada uma, assim como os agentes das outras CLIs que têm essa flag.
O Codex consegue trabalhar em vários repositórios?
Sim. O Codex começa num espaço de trabalho, --add-dir torna outro diretório gravável ao lado dele e writable_roots no config.toml guarda uma lista permanente. O AgentsRoom passa --add-dir a cada agente Codex do projeto para cada pasta vinculada, inclusive quando o agente retoma uma sessão, e o brief dele diz para rodar o git de dentro de cada repositório.
Um projeto pode incluir vários repositórios git?
Sim. O projeto mantém a pasta principal, onde os agentes começam, e vincula os outros repositórios. Cada um mantém o próprio controle de versão. Na aba Alterações, o seletor de repositório alterna entre a pasta do projeto e cada repositório vinculado para ler o diff, fazer o commit e o push.
Minhas pastas são movidas, copiadas ou viram links simbólicos?
Não. O AgentsRoom só guarda os caminhos delas e os passa aos agentes ao iniciar. Nada muda no disco quando você adiciona ou remove uma pasta vinculada.
Quais CLIs de agente recebem as pastas vinculadas?
Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code e Mistral Vibe recebem cada pasta pela própria flag --add-dir. OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin e Cursor não têm essa flag: encontram as pastas no brief e as abrem pelo caminho completo quando o sandbox delas permite.
O agente lê o CLAUDE.md de uma pasta vinculada?
Não por padrão. O Claude Code carrega as skills, os comandos e os subagents de um diretório passado com --add-dir, mas o CLAUDE.md dele só quando CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 está definido, e o AgentsRoom não define isso por você. O que todo agente recebe é o brief: onde fica cada pasta vinculada, que ela faz parte do projeto e que mantém o próprio controle de versão.
Os worktrees e o commit automático cobrem as pastas vinculadas?
Não, eles ficam na pasta do projeto: um worktree por ticket, os commits automáticos quando um ticket é concluído e os diffs das etapas de equipe. Numa pasta vinculada, revise e faça o commit manualmente pela aba Alterações.
As pastas vinculadas me acompanham nos meus outros computadores?
Não. A lista é salva no computador onde você a criou, porque o caminho de uma pasta só existe ali. Os agentes iniciados num servidor remoto via SSH também não recebem as pastas. O resto do projeto, os agentes, o backlog e as configurações, acompanha a sua conta como de costume.
Funciona no Windows e no Linux?
Sim, no macOS, no Windows e no Linux. No Windows, as letras de unidade e os dois tipos de barra são entendidos, e cada --add-dir vai entre aspas para o PowerShell.
Você também pode gostar
Multiprojeto · Multiagente · Paralelo
O AgentsRoom roda vários agentes de IA em Claude, Codex, GitHub Copilot CLI, Cursor e outras 10 CLIs de agentes em paralelo em vários projetos, tudo em uma única janela. Papéis com código de cores, status ao vivo, contadores por projeto, notificações nativas no desktop e no celular. A alternativa visual a 12 abas de terminal e ao caos das sessões do Claude Code espalhadas entre iTerm2, Warp e tmux.
Worktrees git
Dê a cada agente de IA ou ticket o próprio worktree git, pronto para compilar (dependências instaladas, .env copiados), depois revise, faça commit e o merge em uma única janela.
Revisão por Agente
Revise as alterações de código de cada agente IA separadamente. O AgentsRoom rastreia qual agente Claude Code modificou quais arquivos. Filtre diffs por agente, revise individualmente, faça commits por agente para um histórico git limpo.
Multi-Provider
AgentsRoom suporta 14 provedores de codificação IA: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe, Kimi Code, Amp, oh-my-pi, Freebuff, Devin e Cursor. Atribua um provedor diferente por agente, troque de provedor durante a conversa e mantenha todo o contexto com handoff automático. A melhor ferramenta de codificação IA multi-provider.
Conexões SSH
Salve suas conexões SSH, abra um terminal integrado via SSH e execute o Claude Code, o Codex ou o Antigravity CLI diretamente no seu servidor remoto ou VPS. Autenticação por chave SSH ou senha, perfis de conexão por projeto, sem precisar de um cliente SSH separado.
Dê aos seus agentes o projeto inteiro
Baixe o AgentsRoom, abra o seu repositório principal como projeto e vincule os outros em Configurações do projeto, Geral, Pastas vinculadas.
App complementar: acompanhe seus agentes em qualquer lugar
Use Claude, Codex, Antigravity CLI ou outro provedor de IA.
Envie bugs e pedidos direto para o seu backlog público.