Um git worktree é uma cópia separada do seu repositório em uma branch própria. Ele compartilha o mesmo histórico do git que o repositório principal, mas tem arquivos próprios em outra pasta. Você pode manter quantos quiser abertos ao mesmo tempo.
o problema que worktrees resolvem
Normalmente, seu repositório fica em uma pasta com uma branch ativa. Para trabalhar em duas funcionalidades ao mesmo tempo, você teria que guardar as mudanças com stash, trocar de branch, fazer o outro trabalho, voltar e restaurar o stash. É um saco.
Com worktrees, você ganha uma segunda pasta que já está em outra branch. Trabalhe na Funcionalidade A em uma pasta e na Funcionalidade B em outra. Sem stash e sem trocar de branch. As duas existem ao mesmo tempo.
por que isso importa para agentes de ia
Se você rodar dois agentes de IA na mesma pasta, eles vão sobrescrever as mudanças um do outro. O Agente A edita auth.ts. O Agente B também edita auth.ts. Quem salvar por último vence. O trabalho do outro agente desaparece.
Worktrees resolvem isso. Cada agente recebe sua própria pasta, branch e cópia dos arquivos. Os dois podem editar auth.ts ao mesmo tempo sem atrapalhar um ao outro. Quando terminarem, você faz merge de cada branch separadamente.
como isso fica no disco
my-project/ ← your main repo (main branch)
../my-project-feature-a/ ← worktree (feature-a branch)
../my-project-feature-b/ ← worktree (feature-b branch)
As três pastas compartilham o mesmo histórico do git. Depois do merge, os commits feitos em um worktree aparecem nos outros. Mas as mudanças não commitadas ficam totalmente isoladas.
como o pane automatiza isso
Você não precisa rodar comandos do git. Ao criar um novo pane no Pane:
O Pane cria o worktree e a branch para você.
Ele copia suas variáveis de ambiente, node_modules e outras pastas importantes. Assim, seu agente pode começar na hora.
Quando você arquiva o pane, o Pane limpa o worktree automaticamente.
o jeito manual (para referência)
Se você quisesse fazer isso sem o Pane:
git worktree add ../feature-a feature-a
cd ../feature-a
claude # start your agent here
# when done:
git worktree remove ../feature-a
Um git worktree é um checkout separado do seu repositório. Ele tem pasta, branch e arquivos próprios, mas compartilha o mesmo histórico do git que o repositório principal. Você pode abrir vários worktrees ao mesmo tempo, cada um em uma branch diferente.
Uma branch é só um ponteiro para um commit. Cada pasta só pode ter uma branch ativa por vez. Um worktree cria uma segunda, terceira ou quarta pasta, cada uma com sua própria branch ativa. Você pode editar os arquivos de todas elas ao mesmo tempo.
Um clone copia o repositório inteiro, incluindo todo o histórico do git. Um worktree compartilha esse histórico com o repositório original. Por isso, quase não ocupa espaço extra e fica sincronizado automaticamente.
Se dois agentes trabalharem nos mesmos arquivos e na mesma pasta, eles vão sobrescrever as mudanças um do outro. Worktrees dão uma cópia isolada para cada agente. O Agente A pode editar auth.ts em um worktree enquanto o Agente B edita auth.ts em outro. Cada um fica em uma branch diferente, sem conflitos.
Sim. Quando você cria um pane com worktrees ativados, o Pane roda git worktree add, configura a branch e copia suas variáveis de ambiente e node_modules. Ao arquivar o pane, ele limpa tudo.
Sim. Desative 'Usar worktrees' na janela Novo pane. O agente vai rodar na sua árvore de trabalho principal, sem uma branch isolada. Isso ajuda em tarefas rápidas e pontuais que não precisam de isolamento.
Sim. Cada worktree recebe o monorepo inteiro. Assim, os agentes podem trabalhar em pacotes diferentes em paralelo. Limite cada agente à pasta do seu pacote e eles não vão se atrapalhar.
Aviso do Windows SmartScreenO download direto pode exibir um aviso do SmartScreen enquanto o Pane não é assinado. O Pane é totalmente open source. Você pode auditar o código e compilar por conta própria.1. Clique em Mais informações2. Clique em Executar assim mesmo3. Continue a instalaçãoA instalação pelo PowerShell baixa a versão oficial diretamente e evita a maioria dos problemas com downloads pelo navegador.instalação global via npm
