Rode dez agentes em paralelo e seu repositório Git quebra primeiro

O discurso sobre agentes de código foi o mesmo o ano todo: eles rodam sem supervisão, então você deveria rodar vários ao mesmo tempo. Cinco, dez, mais. Um no refactor de autenticação, um no teste instável, um na migração que ninguém quer tocar.
As ferramentas aguentam na maior parte. Aí você tenta, e o que quebra é o seu diretório de trabalho.
Dois agentes em um mesmo checkout sobrescrevem os arquivos um do outro em um minuto. A solução está no git desde 2015: as worktrees, que dão a cada branch seu próprio diretório enquanto compartilham um único banco de objetos. O git sabe fazer isso. A interface do git para fazer isso é ruim o bastante para que quase ninguém use.
Worktrunk é uma CLI em Rust que conserta a interface. Tem 11.900 estrelas, cerca de 2.200 delas da última semana, e é MIT ou Apache-2.0 dependendo de qual você preferir.
O problema de digitar três vezes
Criar uma worktree no git exige digitar o nome da branch três vezes:
git worktree add -b feat ../repo.feat cd ../repo.feat
Duas dessas três são redundantes. Elas existem porque o comando quer um caminho e uma branch, e o caminho quase sempre pode ser derivado da branch. Parece um incômodo pequeno. É a razão pela qual as worktrees continuaram sendo uma técnica para gente com opiniões fortes em vez de um padrão.
O Worktrunk endereça worktrees por nome de branch e calcula o caminho a partir de um template configurável. Qualquer comando que aceita uma branch também aceita o caminho da worktree que a contém. Então a dança desajeitada de três linhas vira:
wt switch -c -x claude feat
Crie uma branch, crie a worktree dela e inicie o Claude nela, de onde você estiver. A flag -x executa um comando depois da troca. Tudo o que você acrescentar depois de um separador é passado para esse comando, e é assim que você entrega ao agente a primeira instrução:
wt switch -x claude -c feature-auth
Três desses em um único shell e você tem três agentes em três branches, isolados, sem nenhuma coordenação entre eles.
Instalação
Homebrew no macOS ou Linux: brew install worktrunk && wt config shell install. Cargo, pacman, conda-forge e pixi funcionam todos. No Windows é winget install max-sixty.worktrunk seguido de git-wt config shell install.
A nota sobre o Windows vale repetir porque vai pegar alguém: wt já aponta para o Windows Terminal, então o Winget instala a ferramenta como git-wt para evitar a colisão. Você também pode desativar o alias do Windows Terminal nos aliases de execução de aplicativos e usar wt diretamente.
O passo config shell install não é opcional. Ele instala o hook de shell que permite a um comando mudar seu diretório atual, e esse é o mecanismo inteiro por trás do wt switch. Pule e todo comando parece não fazer nada.
Os comandos que importam
Quatro deles cobrem a maior parte do fluxo de trabalho.
wt switch te move. wt list mostra cada worktree com marcadores de status: @ para onde você está, + para mudanças em stage, ↑1 para um commit à frente da main, ⇡ para commits não enviados. Só essa saída já é melhor que git worktree list, que te dá caminhos e nada mais.
wt remove limpa, apagando a worktree e a branch juntas, o que no git são dois comandos e um único lugar para errar.
wt merge main é o interessante. Ele faz squash da branch atual, rebaseia sobre a main, faz fast-forward e remove a worktree, em um passo. Se você já resolveu o mesmo conflito três vezes em três branches paralelas, sabe por que isso existe. O paralelismo multiplica o problema de merge, e o problema de merge já era a parte menos agradável do trabalho.
Também existe wt switch pr:123, que pula direto para a branch por trás de um pull request. Recurso pequeno, qualidade de vida desproporcional.
Armazenamento é a parte da qual ninguém te avisa
Dez worktrees significam dez cópias de node_modules e dez cópias de target/. Em um notebook isso são centenas de gigabytes, e o primeiro cargo build em cada uma leva quatro minutos.
O Worktrunk lida com isso com caches de build copy-on-write. Em sistemas de arquivos que suportam, APFS no macOS, btrfs e XFS com reflinks no Linux, as worktrees compartilham o diretório de build e só divergem quando um arquivo muda. O primeiro build paga. Os nove seguintes pegam emprestado.
É o tipo de recurso que revela para que o autor realmente usa a ferramenta. Ninguém adiciona caches de build compartilhados a um gerenciador de worktrees por marketing. Adiciona depois da quarta vez que o disco encheu.
O detalhe relacionado é hash_port, um filtro de template que dá a cada worktree uma porta única. Dez worktrees, dez servidores de desenvolvimento, sem colisão de porta, sem contabilidade manual. Combine com um hook post-start que instala dependências e sobe o servidor, e uma worktree nova fica totalmente operacional no momento em que o agente começa.
Hooks são o lado afiado
Hooks executam comandos de shell automaticamente em momentos definidos: depois que uma worktree inicia, antes de um merge, depois de um merge. Hooks post-start são o jeito de conseguir configuração de ambiente de graça.
Eles também são execução de código arbitrário disparada por uma operação do git. Um repositório pode trazer uma configuração que executa algo no wt switch, e se você clonar e trocar para uma branch, você executou. É a mesma classe de risco do npm install rodando um script postinstall, e merece o mesmo tratamento: leia a configuração antes de confiar no repositório.
A resposta da própria ferramenta é que hooks são declarados em configuração que você controla. Se isso basta depende do seu modelo de ameaça, e para qualquer um que clona repositórios desconhecidos vale uma reflexão.
O que ele não conserta
Worktrees compartilham um único diretório .git, o que significa que compartilham referências de branch, stash e configuração. Dois agentes não podem fazer checkout da mesma branch. Um git rebase em uma worktree muda o histórico sobre o qual outra worktree está sentada. Entradas de reflog se intercalam de formas que tornam o trabalho forense mais difícil.
O Worktrunk deixa o caso comum agradável e não muda o modelo por baixo. Se seus agentes precisam de repositórios genuinamente independentes, você quer clones separados, e aí perde o armazenamento de objetos compartilhado que torna as worktrees baratas desde o começo.
Há também um problema de coordenação que a ferramenta não toca. Dez agentes em dez branches vão produzir dez pull requests que mexem nos mesmos três arquivos, e nenhuma quantidade de gestão de worktrees faz isso fazer merge limpo. As equipes que tiram valor do paralelismo parecem ser as que atribuem áreas disjuntas, não as que rodam mais agentes.
Por que esse tipo de ferramenta está ganhando atenção
Frameworks de agentes ficam com os anúncios. Os utilitários que tornam agentes usáveis ficam com as estrelas.
Esse padrão se repetiu o ano todo: camadas de memória, modos de permissão, sandboxes, gerenciadores de worktree. Cada um existe porque o modelo ficou bom o bastante para fazer o trabalho e o ambiente ao redor nunca foi projetado para um trabalhador que não se cansa, não faz perguntas e vai rodar feliz por quarenta minutos no diretório errado.
O Worktrunk é uma resposta pequena e focada a uma dessas lacunas. Suas 11.900 estrelas contam os desenvolvedores que tentaram rodar três agentes ao mesmo tempo e descobriram que a parte difícil era o sistema de arquivos.
Artigos relacionados
Uma planilha comunitária de toques que desliga os anúncios dos Android chineses
Não mexe no sistema, não desbloqueia nada, não faz flash de nada. Só vira os botões que os fabricantes já deixaram à mostra. O preço é uma lista que alguém precisa continuar escrevendo.
GPT Image 2.6 manteve o preço por token e elevou a fatura
O GPT Image 2.6 mantém cada tarifa por token do 2.5 e mesmo assim custa mais por imagem, porque boa parte do trabalho acontece agora nos tokens de saída. Onze dias após o lançamento, a estrutura de preços diz mais que o ranking.
Alguém reconstruiu o IDM por fora e anotou o que não tocou
Uma reimplementação em Rust do Internet Download Manager promete 5 vezes a velocidade e 86 idiomas. O documento mais interessante é o parágrafo que explica como ela foi feita sem copiar nada.
Rune é um framework de UI em Rust feito para que um agente possa verificar o próprio trabalho
Rune renderiza sem interface, despeja sua árvore de elementos e aceita entrada roteirizada, o que dá a um agente de código um sinal diffável que um screenshot nunca oferece. O framework está em pré-lançamento e não aceita pull requests.