k1LoW/git-wt

O que é?

Recursos principais

• 01Alterna para uma worktree ou cria uma branch e uma worktree com um único comando `git wt <branch>`.
• 02Exclusão segura que preserva alterações não commitadas e branches não mescladas, além de uma opção para forçar a exclusão.
• 03Renomeia o diretório da worktree e sua branch em conjunto.
• 04Copia arquivos ignorados pelo Git, não rastreados ou modificados para novas worktrees, ou cria links simbólicos para eles.
• 05Executa hooks após a criação ou antes da exclusão.
• 06Integração com zsh, bash, fish e PowerShell, com suporte à conclusão de comandos.

Casos de uso

• Trabalhar em várias branches ao mesmo tempo sem usar stash nem alternar branches em um único checkout.
• Revisar um pull request em um diretório separado sem mexer no trabalho atual.
• Compartilhar diretórios grandes de dependências entre worktrees usando links simbólicos para economizar espaço em disco e tempo de configuração.
• Integrar a alternância entre worktrees ao fzf, peco ou tmux para fazer seleções interativas.

Início rápido

1. 1

   Instalar com Go

   go install github.com/k1LoW/git-wt@latest
2. 2

   Ou instalar com Homebrew

   brew install k1LoW/tap/git-wt
3. 3

   Listar os worktrees do repositório

   git wt
4. 4

   Alternar para um worktree de uma branch ou criar um

   git wt feature-branch

Antes de usar

• !A integração com o shell para alternar diretórios automaticamente está marcada como experimental no bash, fish e PowerShell.

Em coleções

Tópicos

Perguntas frequentes

O que é git-wt?

Um subcomando do Git que simplifica o uso de git worktree: alterna, cria, exclui e renomeia worktrees pelo nome da branch ou do diretório. git-wt é um subcomando do Git que oferece uma interface mais simples para `git worktree`. Ao executar `git wt <branch>`, você alterna para uma worktree existente ou cria uma, incluindo a branch caso ela ainda não exista. É possível listar worktrees (com saída JSON opcional), excluí-las e renomeá-las, alterando o diretório e a branch juntos.

git-wt é gratuito? Qual é a licença?

git-wt é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

git-wt ainda é mantido?

Manutenção ativa. O último commit de git-wt foi em 15 de out. de 2026.

Para que posso usar git-wt?

Trabalhar em várias branches ao mesmo tempo sem usar stash nem alternar branches em um único checkout. Revisar um pull request em um diretório separado sem mexer no trabalho atual. Compartilhar diretórios grandes de dependências entre worktrees usando links simbólicos para economizar espaço em disco e tempo de configuração. Integrar a alternância entre worktrees ao fzf, peco ou tmux para fazer seleções interativas.

Como instalar git-wt?

Instalar com Go: go install github.com/k1LoW/git-wt@latest Ou instalar com Homebrew: brew install k1LoW/tap/git-wt Listar os worktrees do repositório: git wt Alternar para um worktree de uma branch ou criar um: git wt feature-branch

Onde consigo git-wt?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/k1LoW/git-wt