Worktrees paralelos

Compatível com dr3.4.25

Git worktrees permitem ter a mesma base de código em vários diretórios ao mesmo tempo, cada um em sua branch. O plugin transforma isso em sessões Claude paralelas de verdade: /dr:worktree:spawn provisiona de 1 a 3 worktrees como diretórios irmãos do repositório e abre uma sessão Claude Code em cada um — três tarefas independentes avançando ao mesmo tempo, sem uma pisar na outra.

Para cada nome passado, o comando cria ../<projeto>-<nome>/ na branch worktree-<nome>, copia .dr_ai/, os arquivos CLAUDE.md do repositório e os caminhos listados em .worktreeinclude (arquivos ignorados pelo git que o projeto precisa, como .env; só caminhos literais, padrões glob são ignorados com aviso), detecta a stack pelos arquivos de manifesto e lockfile e instala as dependências, e abre uma aba de terminal com claude --dangerously-skip-permissions rodando. A aba abre no iTerm quando ele está instalado; senão, no tmux se você já estiver dentro de uma sessão tmux, ou no Terminal.app. A variável SPAWN_WORKTREES_TERMINAL (iterm, terminal ou tmux) força a escolha. iTerm e Terminal.app são abertos via AppleScript, então fora do macOS use tmux: a sessão abre numa janela da sessão tmux claude-fleet (nome configurável em SPAWN_WORKTREES_TMUX_SESSION). SPAWN_WORKTREES_SKIP_INSTALL=1 pula a instalação de dependências.

Ciclo de vida

Comando	O que faz
/dr:worktree:spawn <a> [b] [c]	Cria as worktrees e abre as sessões (até 3 por vez)
/dr:worktree:list	Lista as worktrees com branch, ahead/behind, estado sujo e Claude em execução
/dr:worktree:status <nome>	Detalhe de uma worktree: diff, arquivos, CI e estado da sessão
/dr:worktree:remove <nome>	Remove a worktree e a branch, recusando se houver mudanças não commitadas ou commits não enviados (--force ignora a checagem)
/dr:worktree:cleanup	Remove em lote as worktrees já mergeadas e sem mudanças pendentes, e limpa metadados órfãos (--dry-run mostra antes)
/dr:worktree:config	Gera ou atualiza o .worktreeinclude interativamente

Atenção

O limite de 3 worktrees por chamada é deliberado: é o teto prático de sessões que uma pessoa consegue revisar com atenção. As sessões abrem com --dangerously-skip-permissions, sem pedir confirmação a cada ação — reserve para tarefas que você vai acompanhar.

Ver também

• /dr:spawn — paralelismo de agentes dentro de UMA sessão
• O diretório .dr_ai — copiado para cada worktree