Três agentes, um repositório — e uma rota de colisão
Executar múltiplos agentes de IA em um único checkout do Git é uma colisão à espera de acontecer. O Agente A, no meio de uma refatoração, de repente quebra os testes do Agente B devido a dependências compartilhadas ou edições de arquivos conflitantes. Esse problema de pasta compartilhada paralisa o desenvolvimento paralelo.
Git worktrees oferecem uma solução imediata: cada tarefa recebe um diretório isolado, sua própria branch e um workspace limpo. Esse segundo checkout compartilha o histórico do repositório, mas os agentes não estão mais escrevendo na mesma folha de papel. É uma primitiva poderosa para paralelizar o trabalho.
No entanto, Git worktrees nativos introduzem seu próprio atrito. Criar um exige digitar o nome da branch três vezes, seguido de mudanças manuais de diretório. A limpeza requer mais três comandos para excluir o worktree e sua branch.
Além disso, pedir o status ao Git entrega apenas uma lista estática de caminhos de pastas. Não há uma visão única e dinâmica do que cada agente está fazendo, nenhum comando de merge integrado, e as dependências continuam sendo uma preocupação manual. O suporte nativo a worktree, como o do Claude Code, corrige a criação, mas ainda deixa essas lacunas críticas.
O fluxo de trabalho de uma linha que substitui o malabarismo de pastas
Worktrunk simplifica fluxos de trabalho de agentes paralelos mudando o foco dos caminhos de pasta para as branches. wt switch <branch> cria ou entra em um worktree, eliminando a necessidade de digitar nomes de branch ou lembrar caminhos de diretório. Este comando único configura um ambiente isolado para cada agente.
wt list fornece um painel consolidado e interativo. Ele exibe cada worktree ativo, mostrando sua branch, progresso em relação à main, tamanho do diff e indicadores de atividade do agente (por exemplo, um ícone de robô para agentes ativos, um balão de fala para agentes aguardando entrada). Isso substitui os caminhos de pasta estáticos do git worktree list por um contexto acionável.
Quando um agente termina sua tarefa, wt merge automatiza um ciclo de vida Git complexo de seis etapas em um único comando. Ele faz commit, squash, rebase na main, fast-forward e exclui o worktree finalizado e sua branch. Embora o wt merge automatize a maior parte do trabalho pesado, conflitos ainda interrompem o rebase, exigindo intervenção humana.
O truque de velocidade: reutilize o que cada agente precisa
Executar múltiplos agentes exige uma configuração eficiente. O Worktrunk fornece hooks de ciclo de vida, executando tarefas de configuração automaticamente quando um worktree é criado. Isso elimina instalações repetidas de dependências e configurações manuais de ambiente, garantindo que cada agente comece produtivo.
O Worktrunk também lida com armazenamento e velocidade com wt step copy-ignored. Este comando reutiliza arquivos ignorados como node_modules ou caches de build. Em sistemas de arquivos suportados (APFS, Btrfs), ele emprega copy-on-write, vinculando aos arquivos originais até que ocorram alterações. Isso economiza espaço em disco e tempo significativos.
O vídeo demonstra resultados impressionantes: uma pasta de build Rust de 14GB copiada em ~20 segundos com copy-ignored versus 2 minutos normalmente. Um primeiro build Rust caiu de 68 segundos para 3-4 segundos. Estes são tempos relatados pelo autor, não benchmarks universais. O suporte ao sistema de arquivos é crucial; EXT4 no Linux realiza cópias completas. Além disso, módulos nativos ainda exigem reconstrução. Para mais detalhes sobre a abordagem do Worktrunk para fluxos de trabalho de agentes paralelos, confira Worktrunk — Git worktree management for parallel AI agent workflows.
Gostando do artigo? Receba um assim na sua caixa de entrada toda manhã.
um e-mail por dia · cancele em dois cliques · sem rastreadores de terceiros
Útil, de rápida evolução — e não para todo desenvolvedor
A orquestração terminal-first do Worktrunk contrasta fortemente com os worktrees nativos do Claude Code. Enquanto o Claude Code lida com isolamento básico e limpeza automática, ele deixa o monitoramento de status e os fluxos de trabalho de merge para o usuário. O Worktrunk preenche essa lacuna, oferecendo uma visão única de toda a atividade do agente e um merge de comando único que lida com commits, squashes, rebases e exclusão de worktree.
Este pequeno CLI é pré-1.0 (atualmente v0.81), o que significa que mudanças disruptivas são frequentes; espere atualizar sua configuração. Sua configuração de shell-function para alternância de diretórios é crucial, assim como revisar os hooks de projeto que executam comandos de shell. Conflitos de merge não resolvidos ainda exigem intervenção manual; o Worktrunk interrompe o rebase e devolve o controle a você.
Os benefícios de copy-on-write do wt step copy-ignored dependem do sistema de arquivos. No APFS, é quase instantâneo e economiza espaço significativo, mas em máquinas Linux EXT4, são feitas cópias completas. Módulos nativos ainda precisarão de uma reconstrução em novos worktrees.
Se você executa um agente por vez, worktrees nativos ou Git simples provavelmente são suficientes. No entanto, se você executa regularmente três, cinco ou mais agentes e precisa reduzir a sobrecarga de worktree — desde a configuração e instalação de dependências até verificações de status e limpeza de merge — o Worktrunk fornece a camada de orquestração que faltava.
Perguntas Frequentes
O que é o Worktrunk?
Worktrunk é um CLI de código aberto que simplifica o gerenciamento de Git worktree para desenvolvedores que executam tarefas de codificação paralelas ou agentes de IA.
Como o Worktrunk ajuda com agentes de IA paralelos?
Ele dá a cada tarefa seu próprio branch e checkout, mostra o status do worktree em uma única visualização e simplifica o merge e a limpeza.
O Worktrunk funciona apenas com o Claude Code?
Não. Ele se integra ao Claude Code e suporta outros CLIs de agentes, incluindo Codex, OpenCode e Gemini CLI.
O Worktrunk elimina conflitos de merge?
Não. Worktrees isolam arquivos durante o desenvolvimento, mas alterações que se sobrepõem ainda podem entrar em conflito quando são mescladas.
O Worktrunk está pronto para produção?
Ele é pré-1.0, portanto, espere possíveis mudanças disruptivas e revise os hooks de projeto antes de aprovar seus comandos de shell.