Sobre o projeto
Worktrunk é uma ferramenta de linha de comando que torna os git worktrees tão fáceis de gerenciar quanto branches, voltada especificamente para desenvolvedores que executam múltiplos agentes de IA (como Claude Code ou Codex) em paralelo. Ela fornece três comandos principais—`wt switch`, `wt list` e `wt merge`—que simplificam a criação, troca, listagem e limpeza de worktrees. Os worktrees são endereçados pelo nome do branch, com caminhos calculados a partir de um template configurável, e os comandos também aceitam caminhos de worktree.
Os principais recursos incluem:
- **Comandos principais**: `wt switch` para criar/trocar worktrees (com `-c` para criar e `-x` para executar um comando como iniciar um agente), `wt list` para mostrar todos os worktrees com status, informações de CI e resumos gerados por IA, `wt merge` para squash/rebase/merge e limpeza em uma única etapa, e `wt remove` para limpeza.
- **Automação de fluxo de trabalho**: Hooks para eventos de create, pre-merge e post-merge; mensagens de commit geradas por LLM; seletor interativo com status de CI em streaming e pré-visualizações de diff/log/PR; compartilhamento de cache de build copy-on-write (para `target/`, `node_modules/`, etc. em APFS, btrfs, XFS); checkout de PR via `wt switch pr:123`; portas de servidor de desenvolvimento por worktree via filtro de template `hash_port`; aliases e variáveis por branch.
- **Suporte a agentes paralelos**: Inicie múltiplos agentes em worktrees separados com comandos simples, por exemplo, `wt switch -x claude -c feature-a -- 'Add user authentication'`.
- **Instalação**: Disponível via Homebrew, Cargo, Winget (Windows, como `git-wt`), pacman do Arch Linux, Conda/Pixi. A integração com o shell (`wt config shell install`) permite comandos que alteram o diretório.
- **Documentação**: Documentação completa em worktrunk.dev, com guias para hooks, commits por LLM, fluxos de merge, dicas e padrões, e extensão via aliases.
Worktrunk é escrito em Rust e é open-source sob MIT ou Apache-2.0. Ele foi projetado para reduzir a fricção de gerenciar muitos worktrees paralelos, tornando-o ideal para fluxos de desenvolvimento orientados por agentes de IA.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.