Repolode
Enviar
max-sixty

max-sixty/worktrunk

Uma CLI em Rust para gerenciar git worktrees pelo nome da branch, feita para executar vários agentes de programação com IA em paralelo.

Ver no GitHubSite
Estrelas
9,341
Forks
333
Issues abertas
67
Último commit
há 11 horas

O que é?

Worktrunk é uma ferramenta de linha de comando para gerenciar git worktrees. Em vez de lidar com caminhos e comandos git brutos, você acessa cada worktree pelo nome da branch: `wt switch` alterna entre elas, `wt list` mostra o status e `wt remove` remove a worktree e a branch associada. Criar uma worktree para uma nova branch exige apenas um comando, e o caminho do diretório é calculado com base em um template configurável.

O projeto foi pensado para fluxos de trabalho em que vários agentes de IA, como Claude Code ou Codex, executam tarefas diferentes ao mesmo tempo, cada um na sua própria worktree para evitar conflitos entre as alterações. Hooks executam comandos em eventos como a criação ou o merge de uma worktree; `wt step copy-ignored` compartilha caches de build, como `target/` ou `node_modules/`, entre worktrees em sistemas de arquivos compatíveis; e `wt switch pr:123` faz checkout da branch de um pull request.

O Worktrunk também inclui um comando local de merge que faz squash, rebase e fast-forward para a branch principal antes de limpar tudo, além de mensagens de commit opcionais geradas por LLM e o status do CI exibido em `wt list --full`. A instalação pode ser feita via Homebrew, Cargo, Winget, pacotes do Arch Linux e conda-forge, e a ferramenta configura a integração com o shell para que os comandos possam mudar de diretório.

Recursos principais

  • 01Alternar entre, criar, listar e remover worktrees pelo nome da branch
  • 02Iniciar um agente de IA, como Claude, em uma nova worktree com um único comando
  • 03Templates configuráveis para os caminhos dos diretórios das worktrees
  • 04Hooks que executam comandos nos eventos de criação, pré-merge e pós-merge
  • 05Compartilhar caches de build, como `target/` e `node_modules/`, entre worktrees em APFS, btrfs e XFS
  • 06Fazer checkout de branches de pull requests com `wt switch pr:123`

Casos de uso

  • Executar vários agentes de programação com IA em funcionalidades diferentes sem que as alterações entrem em conflito
  • Revisar e testar várias branches lado a lado, cada uma com sua própria porta para o servidor de desenvolvimento
  • Fazer squash, rebase e merge de uma branch de funcionalidade concluída na main pelo terminal
  • Fazer checkout do pull request de um colega em um diretório separado sem afetar o trabalho atual

Início rápido

  1. 1

    Instale pelo Homebrew e configure a integração com o shell

    brew install worktrunk && wt config shell install
  2. 2

    Crie um worktree para um novo recurso

    wt switch --create feature-auth
  3. 3

    Liste todos os worktrees com o status

    wt list

Antes de usar

  • A licença está listada como NOASSERTION nos metadados; por isso, verifique os termos de licença do repositório antes de usar.
  • A integração com o shell é necessária para que os comandos alterem diretórios, e no Windows o nome do comando padrão é diferente (git-wt).

Tópicos

#git#git-worktree#cli#ai-agents#developer-tools#rust#claude-code#parallel-development#agents#codex

Perguntas frequentes

O que é worktrunk?
Uma CLI em Rust para gerenciar git worktrees pelo nome da branch, feita para executar vários agentes de programação com IA em paralelo. Worktrunk é uma ferramenta de linha de comando para gerenciar git worktrees. Em vez de lidar com caminhos e comandos git brutos, você acessa cada worktree pelo nome da branch: `wt switch` alterna entre elas, `wt list` mostra o status e `wt remove` remove a worktree e a branch associada. Criar uma worktree para uma nova branch exige apenas um comando, e o caminho do diretório é calculado com base em um template configurável.
worktrunk é gratuito? Qual é a licença?
worktrunk é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
worktrunk ainda é mantido?
Manutenção ativa. O último commit de worktrunk foi em 21 de out. de 2026.
Para que posso usar worktrunk?
Executar vários agentes de programação com IA em funcionalidades diferentes sem que as alterações entrem em conflito Revisar e testar várias branches lado a lado, cada uma com sua própria porta para o servidor de desenvolvimento Fazer squash, rebase e merge de uma branch de funcionalidade concluída na main pelo terminal Fazer checkout do pull request de um colega em um diretório separado sem afetar o trabalho atual
Como instalar worktrunk?
Instale pelo Homebrew e configure a integração com o shell: brew install worktrunk && wt config shell install Crie um worktree para um novo recurso: wt switch --create feature-auth Liste todos os worktrees com o status: wt list
Onde consigo worktrunk?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/max-sixty/worktrunk

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados