# Workspaces paralelos: um git worktree isolado por tarefa

> Os workspaces paralelos do Tallos dão a cada tarefa um git worktree próprio: pasta separada, branch separada e terminais de agente próprios. Assim, Claude Code, Codex, Gemini CLI ou qualquer outro agente trabalham no mesmo repositório ao mesmo tempo sem sobrescrever um ao outro. Você revisa o diff de cada workspace e faz commit, push e pull request a partir dele.

- Canonical: https://runtallos.com/pt/recursos/workspaces-paralelos
- English: https://runtallos.com/features/parallel-workspaces.md
- Atualizado em: 2026-09-29
- Section: Recursos

## Em resumo

- Cada workspace é um git worktree de verdade, com branch própria
- Comece da branch base, de outra branch, de um commit ou de uma branch remota
- Vincule um item do GitHub, GitLab, Linear ou Jira ao criar
- Diff, commit, push e PR por workspace
- Roda localmente ou em um host SSH

## 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](https://runtallos.com/pt/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](https://runtallos.com/pt/aprenda/git-worktrees-para-agentes-de-ia) explica a parte do git.

**Um checkout só**
- Uma branch por vez
- Stash, troca de branch e restaura para mudar de tarefa
- Dois agentes brigam pelos mesmos arquivos
- A revisão mistura tarefas diferentes

**Um workspace por tarefa**
- Uma branch por tarefa, todas abertas ao mesmo tempo
- Troque de tarefa pela barra lateral
- Cada agente edita só o próprio worktree
- Cada workspace tem o próprio diff

## 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](https://runtallos.com/pt/recursos/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](https://runtallos.com/pt/recursos/squads) 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. **Crie três workspaces** — Todos a partir da mesma branch, por exemplo `fix-bug`, `fix-bug-2` e `fix-bug-3`.
2. **Inicie um agente diferente em cada** — Claude Code em um, Codex em outro, Gemini CLI ou OpenCode no terceiro.
3. **Dê o mesmo prompt aos três** — Divida os painéis para ver os três trabalhando lado a lado.
4. **Revise cada diff** — Quando terminarem, compare os resultados e anote o vencedor.
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](https://runtallos.com/pt/aprenda/rodar-varias-sessoes-do-claude-code).

> Baixe o Tallos e dê a cada agente seu próprio workspace. → https://runtallos.com/signup

## Qual é o ciclo de vida de um workspace?

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

| Etapa | O que acontece |
| --- | --- |
| **Criar** | Dê nome à tarefa, escolha de onde ela parte e, se quiser, vincule um item do GitHub, GitLab, Linear ou Jira. |
| **Trabalhar** | Terminais de agente, abas de editor, abas de navegador e divisões, tudo restrito a este worktree. |
| **Revisar** | Um diff contra a branch de origem, com notas por linha que você devolve ao agente. |
| **Entregar** | Commit, push, pull request e acompanhamento dos checks, pelo painel de controle de código-fonte. |
| **Arquivar ou excluir** | Arquive, coloque para dormir ou exclua. Excluir remove a pasta e a branch depois de uma confirmação. |

_O ciclo de vida de um workspace no 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. **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](https://runtallos.com/pt/recursos/revisao-de-diff).
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. **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. **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. **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.

> **Git puro continua funcionando** — Todo workspace do Tallos é um git worktree de verdade. Abra um terminal nele e rode `git rebase`, `git cherry-pick` ou `git merge` normalmente; o Tallos reconhece as mudanças.

## Perguntas frequentes

### Os workspaces do Tallos são git worktrees de verdade?

Sim. Cada workspace é criado com `git worktree`, tem branch e pasta próprias e funciona com qualquer comando git que você rodar no terminal dele.

### Dois agentes de IA podem trabalhar no mesmo repositório ao mesmo tempo?

Sim, desde que cada um tenha seu workspace. Cada agente só edita os arquivos do próprio worktree, então um não sobrescreve as mudanças do outro.

### Excluir um workspace apaga minha branch?

Excluir um workspace remove a pasta e a branch depois de uma confirmação. Se o git mantiver uma branch porque ela pode ter commits não mesclados, o Tallos lista essa branch para você decidir o que apagar.

### Como levo meu arquivo .env para um worktree novo?

Liste o arquivo em um `.worktreeinclude` na raiz do repositório e o Tallos copia para cada worktree novo. Para pastas grandes como `node_modules`, use Caminhos Compartilhados do Worktree nas configurações do repositório.

### Posso criar um workspace a partir de uma issue do Linear ou do Jira?

Sim. Cole o link da issue, ou de um PR do GitHub ou MR do GitLab, ao criar o workspace. O Tallos dá nome ao workspace, vincula o item e mostra no card.

### Os workspaces podem rodar em outra máquina?

Sim. Escolha um host SSH em Executar em ao criar o workspace, e os agentes rodam naquela máquina com a mesma interface.

---

**Rode seus agentes em paralelo com o Tallos** — Claude Code, Codex, Gemini e mais de 30 agentes — cada um no seu workspace, com squads, chat, terminais e revisão num só app. Usa as assinaturas que você já tem.

https://runtallos.com/signup (macOS 13+ · Windows 10+)