Workspaces paralelos: um git worktree isolado por tarefa

O que é um workspace paralelo?

Um workspace paralelo é uma cópia isolada do seu repositório, criada com git worktree, que pertence a uma única tarefa. Ele tem branch própria, arquivos próprios no disco e seus próprios terminais de agente, abas de editor e abas de navegador. O Tallos é construído em cima desse modelo: em vez de trocar de branch e fazer stash no mesmo checkout, cada feature ou bug ganha um workspace.

É isso que torna seguro rodar agentes de IA em paralelo. Dois agentes na mesma pasta editam os mesmos arquivos e quebram o trabalho um do outro. Dois agentes em dois worktrees, não. Se worktrees são novidade para você, o guia de git worktrees para agentes de IA explica a parte do git.

Como crio um workspace para uma tarefa?

Clique em Novo workspace na barra lateral, dê um nome à tarefa e confirme. O diálogo fecha na hora; o git fetch e o git worktree add continuam em segundo plano enquanto o novo workspace mostra o progresso. Dá para cancelar, ou tentar de novo se falhar.

• Projeto: o repositório ao qual o workspace pertence.
• Começar de: a branch base do repositório (o caminho rápido), outra branch local para empilhar trabalho, um commit específico ou uma branch remota que o Tallos busca.
• Executar em: este computador ou um host SSH, veja workspaces remotos.
• Agente: qual agente iniciar, com Definir como padrão para as próximas vezes.
• Link da tarefa: cole um PR do GitHub, MR do GitLab, issue do Linear ou do Jira. O link aparece no card do workspace e dá nome à branch; no Linear, o Tallos usa o nome de branch sugerido pelo próprio Linear.
• Avançado: defina um nome de branch explícito ou um workspace pai para aninhar na barra lateral.

Agentes também criam workspaces: o comando tallos worktree create faz o mesmo a partir de qualquer terminal, e é assim que o líder de uma squad dá a cada membro um worktree filho próprio.

Como rodo vários agentes no mesmo repositório?

Crie um workspace por agente e inicie um agente diferente em cada um. O padrão clássico é colocar três agentes para disputar a mesma tarefa:

1. 1

   Crie três workspaces

   Todos a partir da mesma branch, por exemplo fix-bug, fix-bug-2 e fix-bug-3.

2. 2

   Inicie um agente diferente em cada

   Claude Code em um, Codex em outro, Gemini CLI ou OpenCode no terceiro.

3. 3

   Dê o mesmo prompt aos três

   Divida os painéis para ver os três trabalhando lado a lado.

4. 4

   Revise cada diff

   Quando terminarem, compare os resultados e anote o vencedor.

5. 5

   Entregue o vencedor e apague o resto

   Faça commit, push e abra o PR a partir do workspace vencedor. Excluir os outros remove as pastas e as branches.

Agentes diferentes erram de formas diferentes. Onde eles concordam, a resposta provavelmente está certa; onde divergem, você achou a parte difícil. A mesma estrutura serve para um único agente várias vezes, veja rodar várias sessões do Claude Code.

Baixe o Tallos e dê a cada agente seu próprio workspace.

Baixar o Tallos →

Qual é o ciclo de vida de um workspace?

Todo workspace passa pelas mesmas cinco etapas, e todas acontecem dentro do Tallos:

A barra lateral agrupa os workspaces por projeto e mostra quais agentes estão trabalhando e quais precisam de você. Dá para fixar trabalhos longos, filtrar a lista e selecionar vários workspaces para agir neles de uma vez.

E os arquivos .env e o node_modules num worktree novo?

Um worktree novo é um checkout limpo, então arquivos ignorados pelo git, como .env ou node_modules, não vêm junto. O Tallos resolve isso de duas formas:

• Caminhos Compartilhados do Worktree nas configurações do repositório: caminhos do checkout principal que aparecem em cada worktree novo, clonados no macOS quando possível, senão vinculados.
• `.worktreeinclude` na raiz do repositório: uma lista de arquivos ou pastas ignorados pelo git para copiar em cada worktree novo, para que cada um tenha sua cópia do .env ou da configuração local do editor.

Como faço merge de um workspace na main?

Você faz merge de um workspace como faria com qualquer branch: por pull request ou com git puro. O Tallos mantém o caminho todo num lugar só.

1. 1

   Revise o diff

   Abra o diff do workspace, leia cada mudança e mande notas de volta ao agente até ficar limpo. Veja revisão de diff.

2. 2

   Faça o commit

   Selecione os arquivos e escreva a mensagem no painel de controle de código-fonte, ou use Gerar com IA para um rascunho.

3. 3

   Faça o push

   O push define o upstream na primeira vez. O Tallos nunca faz force push escondido; force push com lease é uma ação separada e explícita.

4. 4

   Abra o pull request

   Crie o PR ou MR com branch base, título, descrição e rascunho. GitHub, GitLab e Bitbucket Cloud são suportados.

5. 5

   Faça o merge

   Faça o merge pela tela do PR quando os checks passarem, ou ative o auto-merge do GitHub. Depois exclua o workspace.