Um gerenciador de worktrees git
para Claude Code, Codex e qualquer CLI de agente
Marque uma caixa em um ticket, ou escolha um worktree ao adicionar um agente, e ele trabalha no próprio checkout, no próprio branch. Vários agentes alteram o mesmo repositório ao mesmo tempo sem mexer nos arquivos uns dos outros.
Antes de o agente começar, o AgentsRoom instala as dependências e copia seus arquivos .env para o novo worktree, para que ele possa compilar e rodar os testes logo de cara. Quando ele termina, você revisa, faz commit, push e o merge desse worktree pela aba Alterações, no desktop ou pelo celular.
- Agente backend.worktrees/fix-login-redirectPreparado
- Agente frontend.worktrees/settings-dark-modeTrabalhando
- Agente de QA.worktrees/agents/qaRevisão
Três agentes, três worktrees, um repositório: cada checkout é preparado antes de o agente começar, depois revisado e integrado separadamente.
Dois agentes no mesmo checkout são duas pessoas digitando no mesmo arquivo. Um roda o formatador enquanto o outro está no meio de uma edição, um troca de branch debaixo do outro, e o diff que você revisa no fim mistura os dois trabalhos. Um worktree git resolve isso: um segundo checkout do mesmo repositório, na própria pasta e no próprio branch, que compartilha o histórico mas não os arquivos.
Criar um é questão de um único comando git. Conviver com dez é que é difícil: um worktree novo não tem node_modules nem .env, então o primeiro build do agente falha; nada mostra qual agente trabalha onde; e quando o trabalho termina você ainda precisa encontrar a pasta, revisar, fazer commit e o merge.
O AgentsRoom cuida desse ciclo de vida. Um ticket do backlog ou um agente pede um worktree, o AgentsRoom o cria a partir de um branch base atualizado dentro do projeto, em .worktrees/, prepara, inicia o agente nele e dá a você um seletor na aba Alterações para revisar, fazer commit, push e o merge. Funciona do mesmo jeito qualquer que seja a CLI que roda o agente: Claude, Codex, GitHub Copilot CLI, Cursor e outras 10 CLIs de agentes.
Os worktrees continuam opcionais. Um agente sem worktree continua trabalhando na pasta do projeto como antes, e você decide por ticket, por agente ou por modelo de agente.
O que o gerenciador de worktrees faz
Do momento em que uma tarefa pede um checkout isolado até o momento em que o branch dela entra com merge.
Um worktree por ticket do backlog
Marque Programar num worktree separado para esta tarefa em um ticket, escolha um dos worktrees do projeto ou digite o nome de um novo branch, e iniciar o ticket cria o worktree e lança o agente dentro dele.
Escolha um worktree ao adicionar um agente
O card Espaço de trabalho da janela Adicionar agente mostra Principal, os worktrees existentes do projeto e Novo. Um worktree que você mesmo criou com git worktree add também aparece.
Um novo worktree para cada agente de um modelo
Ative Novo worktree por agente em um agente salvo ou em um perfil predefinido, e cada agente criado a partir dele recebe o próprio branch, chamado agents/<modelo> e depois -2, -3, para que as cópias nunca compartilhem um checkout.
Pronto para compilar já no primeiro lançamento
Antes de o primeiro agente começar em um novo worktree, o AgentsRoom copia os arquivos ignorados pelo git de que ele precisa (todos os arquivos .env por padrão) e roda o comando de instalação detectado a partir do seu lockfile: yarn, pnpm, npm, bun, uv, poetry, pipenv, bundle ou composer.
Revise, faça commit e push de cada worktree
O seletor Worktree no topo da aba Alterações leva o diff, a revisão, Commit, Pull e Push para esse checkout. Clicar no indicador de um agente que tem o próprio worktree abre esse worktree diretamente.
Merge quando o ticket é concluído
Com Integrar automaticamente no ramo atual quando a tarefa estiver concluída, marcar o ticket como Concluído faz o merge do branch dele. Ative Fazer commit automaticamente ao concluir o trabalho para que o que o agente deixou sem commit entre no merge.
Como funciona
O caminho de um ticket, do formulário ao merge.
- 1
Peça um worktree no ticket
No formulário do ticket, em Execução, marque Programar num worktree separado para esta tarefa. Escolha um worktree existente entre os chips, ou mantenha o campo Nome do ramo: ele é preenchido a partir do título até você editá-lo, e vira um novo worktree quando a tarefa começa.
- 2
Inicie o ticket
O AgentsRoom busca o branch base (o branch padrão do remoto, ou o Ramo base dos worktrees definido nas configurações do projeto), cria o worktree em .worktrees/<branch>/ e adiciona essa pasta ao .git/info/exclude do clone, para que ela nunca apareça como arquivos não rastreados no seu checkout principal.
- 3
O worktree é preparado, depois o agente começa
O terminal do agente mostra o comando de instalação e a saída dele, uma notificação diz quantos arquivos ignorados foram copiados, e então a CLI do agente começa no worktree. Isso acontece uma vez por worktree; uma instalação que falha nunca bloqueia o agente, o erro fica no terminal dele.
- 4
Revise e faça o merge
Escolha o worktree na aba Alterações para ler o diff e fazer commit. Marque o ticket como Concluído e, com o merge automático ativado, o branch dele entra com merge no branch atual; a confirmação mostra o resultado. O worktree em si fica no disco para uma última olhada.
Claude Code e Codex já criam worktrees. Esta é a diferença.
O Claude Code tem a própria flag: claude --worktree feature-auth cria .claude/worktrees/feature-auth em um branch chamado worktree-feature-auth, copia os arquivos ignorados pelo git listados em um arquivo .worktreeinclude e pergunta se você quer manter ou remover o worktree ao sair. A documentação dele diz claramente que um worktree é um checkout novo e que é você quem instala as dependências, ou pede ao Claude. Os subagentes também podem receber um worktree cada um com isolation: worktree.
O app do Codex gerencia worktrees em $CODEX_HOME/worktrees, inicia esses worktrees em detached HEAD a partir do branch escolhido, também lê .worktreeinclude, roda os scripts de setup de um ambiente local se você escolher um, e mantém os 15 mais recentes por padrão. O Handoff move uma conversa e o código dela entre Local e um worktree. O codex-cli 0.162.1 também tem uma flag --worktree.
Os dois são bons, e cada um pertence a um único fornecedor. O AgentsRoom não substitui nenhum deles: ele coloca o mesmo isolamento um nível acima, onde vivem seus tickets e seus agentes, para todas as CLIs de uma vez, prepara o checkout antes de o agente vê-lo e mantém a revisão, o commit e o merge na janela que você já usa. Verificado no Claude Code 2.1.299 e no codex-cli 0.162.1, em outubro de 2026.
O que você precisa saber
- Um worktree nunca é apagado automaticamente, de propósito, para que você possa revisá-lo. Eles se acumulam em .worktrees/; remova um com git worktree remove quando terminar, nunca enquanto um agente ainda estiver rodando dentro dele.
- Um merge automático que encontra um conflito registra um aviso e o ticket passa mesmo assim para Concluído: resolva esse merge à mão.
- Os worktrees precisam de um repositório git na raiz do projeto. Uma pasta que só agrupa vários repositórios lado a lado não recebe nenhum: abra cada repositório como um projeto separado.
- Um projeto aberto em um servidor SSH tem os worktrees no servidor, sem a etapa de instalação. Um checkout local cujos agentes rodam em um host remoto não pode usar worktrees, e o ticket avisa isso em vez de começar.
- Um agente de QA nunca tem o próprio worktree: ele testa dentro do checkout do agente principal, porque um worktree novo não conteria o trabalho sem commit que ele precisa testar.
Perguntas frequentes
O que é um worktree git, e por que dar um a um agente de IA?
Um worktree git é um segundo checkout do mesmo repositório, na própria pasta e no próprio branch, que compartilha o histórico e o remoto com o seu checkout principal. Dar um a cada agente de código de IA significa que cada agente edita, compila e faz commit da própria cópia dos arquivos, então dois agentes trabalhando ao mesmo tempo nunca sobrescrevem o trabalho um do outro nem trocam de branch debaixo um do outro. Nosso blog tem um guia mais longo sobre a parte do git: Git worktrees: a base para rodar vários agentes de IA sem conflitos.
O Claude Code tem worktrees integrados?
Sim. claude --worktree <nome> (ou -w) cria .claude/worktrees/<nome> em um branch chamado worktree-<nome>, copia os arquivos ignorados pelo git listados em .worktreeinclude e pergunta se você quer manter ou remover o worktree ao sair; os subagentes podem rodar no próprio worktree com isolation: worktree. Ele não instala suas dependências. No AgentsRoom você pode continuar usando esse recurso, ou deixar o ticket ou o agente pedir o worktree, o que também o prepara e o mostra na aba Alterações (verificado no Claude Code 2.1.299).
O Codex suporta worktrees?
O app do Codex, sim: ele cria worktrees gerenciados em $CODEX_HOME/worktrees, em detached HEAD, copia os arquivos ignorados listados em .worktreeinclude, pode rodar os scripts de setup de um ambiente local, mantém os 15 mais recentes e move uma conversa entre Local e um worktree com o Handoff. O codex-cli 0.162.1 tem uma flag --worktree que roda uma sessão em um novo worktree gerenciado. O AgentsRoom dá um worktree a um agente Codex do mesmo jeito que a qualquer outro agente, pelo ticket ou pela janela Adicionar agente.
Quais CLIs de agentes podem rodar em um worktree do AgentsRoom?
Todas: o worktree é simplesmente o diretório de trabalho do agente, qualquer que seja a CLI que roda ali, então Claude, Codex, GitHub Copilot CLI, Cursor e outras 10 CLIs de agentes trabalham nele do mesmo jeito. Kimi Code e Antigravity CLI confiam em uma pasta pelo caminho exato; o AgentsRoom registra um novo worktree como confiável para elas antes do lançamento, para que não parem em uma pergunta de confiança.
Preciso rodar yarn install e copiar meu .env em cada worktree?
Não. Antes de o primeiro agente começar em um novo worktree, o AgentsRoom copia os arquivos ignorados pelo git do checkout principal que correspondem a Arquivos copiados deste checkout (todos os arquivos .env por padrão) e roda o comando de instalação detectado a partir do lockfile na raiz. As duas coisas se configuram em Configurações do projeto > Git > Preparar novos worktrees, onde você pode substituir o comando, por exemplo por pnpm install && pnpm build:deps. Um arquivo que já existe no worktree nunca é sobrescrito.
Como revisar e fazer o merge do que um agente fez no worktree dele?
Abra a aba Alterações e escolha o worktree no seletor Worktree no topo: a lista de arquivos, os diffs, a revisão, Commit, Pull e Push passam a agir nesse checkout. Para um ticket, Integrar automaticamente no ramo atual quando a tarefa estiver concluída faz o merge do branch dele quando você o marca como Concluído, e Fazer commit automaticamente ao concluir o trabalho (Configurações > Backlog) primeiro faz commit do que o agente deixou, para que o merge leve o trabalho inteiro.
Onde ficam os worktrees, e eles são limpos?
Dentro do projeto, em .worktrees/<branch>/, criados a partir do branch padrão do remoto, a menos que você defina um Ramo base dos worktrees nas configurações do projeto. A pasta é adicionada ao .git/info/exclude do clone, nunca ao seu .gitignore, então ela fica fora dos seus commits. Os worktrees nunca são apagados automaticamente: remova um com git worktree remove quando terminar de usá-lo.
Posso usar os worktrees pelo celular ou em um servidor remoto?
Sim, nos dois casos. No celular, a tela Alterações tem o mesmo seletor Worktree, e um ticket que pede um worktree roda nele quando você o inicia pelo celular, preparado pelo app desktop como qualquer outro. Um projeto aberto em um servidor SSH tem os worktrees no servidor, sem a etapa de instalação. Um checkout local cujos agentes rodam em um host remoto não pode usar worktrees, e o ticket avisa você disso em vez de começar.
Para se aprofundar
Git worktrees: a base para rodar vários agentes de IA sem conflitos
Seus agentes sobrescrevem uns aos outros quando rodam em paralelo. O git worktree resolve isso em dois comandos. Veja como usar.
Dez agentes rodaram o mesmo typecheck ao mesmo tempo. A solução era uma pasta.
Dezessete agentes de código no mesmo checkout, dez tsc em paralelo, load average 37 e 87 MB de RAM livre. Um typecheck de noventa segundos levou 7 min 36. Aqui está a medição, por que a máquina não estava calculando, e o pequeno bloqueio compartilhado que resolveu. Copiável para qualquer repositório.
Como Executar de 3 a 8 Agentes de Codificação em Paralelo Sem Perder o Controle
Lançar múltiplos agentes Claude Code ou Codex de uma vez é fácil. Manter o controle é onde tudo desmorona. Aqui está o método que realmente funciona.
Você também pode gostar
Gestão de tarefas
Quadro kanban visual para orquestrar agentes de IA com arrastar e soltar. Crie tarefas em A FAZER, arraste para Em Andamento para iniciar automaticamente um agente Claude e acompanhe a conclusão pelas colunas Pendente e Concluído. Desenvolvimento orientado por backlog para código com IA em paralelo.
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.
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.
Personalize Agentes
Escolha entre 14 papéis de agente integrados, adicione agentes especialistas da The Agency ou crie seu próprio agente de codificação AI personalizado com seu próprio prompt de sistema. Em seguida, compartilhe seus agentes com sua equipe através do chat e publique-os na comunidade para que todos evoluam juntos.
Workflow multi-agente • Handoff • Loop de feedback
O AgentsRoom Agent Teams encadeia agentes de código IA como uma equipa de engenharia de verdade. Editor visual de workflows (canvas estilo n8n) para ligar os papéis Dev, QA, PM, Segurança e DevOps. Handoff automático com resumo, diff do git, riscos e dicas de teste. Portões de qualidade verificados pela máquina (quem decide é a tua suite de testes, não o agente), ramos paralelos de revisão QA e Segurança, ligações condicionais, loops de feedback, teto de ciclos. Escolhe, equipa a equipa, como os papéis correm: um agente que faz morph de papel em papel e guarda todo o contexto, ou um agente vivo por papel, a trocarem mensagens em tempo real. O orquestrador multiagente que faltava aos teus agentes em Claude, Codex, GitHub Copilot CLI, Cursor e outras 10 CLIs de agentes.
Dê a cada agente o próprio checkout
Baixe o AgentsRoom para macOS, Windows ou Linux e deixe vários agentes trabalharem no mesmo repositório sem atrapalhar uns aos outros.
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.