Repolode
Enviar
satococoa

satococoa/wtp

Uma CLI de Git worktree que gera caminhos a partir dos nomes das branches, executa hooks de configuração e remove worktrees junto com suas branches.

Ver no GitHubSite
Estrelas
636
Forks
25
Issues abertas
27
Último commit
há 3 dias

O que é?

wtp (Worktree Plus) é uma ferramenta de linha de comando que adiciona conveniências ao git worktree para gerenciar várias branches em checkouts lado a lado. Ao executar wtp add feature/auth, você cria uma worktree em um caminho derivado do nome da branch, sem precisar digitar caminhos relativos longos manualmente. A ferramenta também pode fazer checkout automático de branches que existem apenas em remotes e exibe um erro quando uma branch existe em vários remotes.

A ferramenta adiciona configuração no nível do projeto por meio de um arquivo .wtp.yml. Os hooks executados após a criação podem copiar arquivos ignorados pelo Git, como .env, da worktree principal, criar symlinks para diretórios compartilhados, como .bin, e executar comandos de configuração, como npm ci ou migrações de banco de dados. wtp remove --with-branch exclui uma worktree e sua branch em uma só etapa, e wtp cd acessa uma worktree pelo nome, com preenchimento por tab para Bash, Zsh e Fish.

wtp é escrito em Go e distribuído pelo Homebrew, por go install e por meio de binários pré-compilados para Linux e macOS. Requer Git 2.17 ou posterior.

Recursos principais

  • 01Gera automaticamente caminhos para worktrees a partir dos nomes das branches.
  • 02Remove uma worktree junto com sua branch usando wtp remove --with-branch.
  • 03Executa hooks após a criação para copiar arquivos, criar symlinks e executar comandos de configuração.
  • 04Faz checkout automático de branches remotas quando não existe uma branch local.
  • 05Oferece wtp cd com preenchimento por tab para Bash, Zsh e Fish.

Casos de uso

  • Trabalhar em várias branches de funcionalidades ao mesmo tempo sem guardar alterações com stash.
  • Preparar novas worktrees com arquivos .env e instalação de dependências em projetos de microsserviços ou monorepos.
  • Limpar branches de funcionalidades concluídas junto com suas worktrees.

Início rápido

  1. 1

    Instale com Homebrew (macOS/Linux)

    brew install satococoa/tap/wtp
  2. 2

    Ou instale com Go

    go install github.com/satococoa/wtp/v2/cmd/wtp@latest
  3. 3

    Crie um worktree com uma nova branch

    wtp add -b feature/new-feature

Antes de usar

  • Requer Git 2.17 ou posterior.
  • Os binários pré-compilados estão disponíveis apenas para macOS com Apple Silicon e Linux, não para Macs com Intel nem Windows.

Em coleções

Ferramentas de CLI e terminal

Tópicos

#git#git-worktree#cli#developer-tools#go#productivity#worktree

Perguntas frequentes

O que é wtp?
Uma CLI de Git worktree que gera caminhos a partir dos nomes das branches, executa hooks de configuração e remove worktrees junto com suas branches. wtp (Worktree Plus) é uma ferramenta de linha de comando que adiciona conveniências ao git worktree para gerenciar várias branches em checkouts lado a lado. Ao executar wtp add feature/auth, você cria uma worktree em um caminho derivado do nome da branch, sem precisar digitar caminhos relativos longos manualmente. A ferramenta também pode fazer checkout automático de branches que existem apenas em remotes e exibe um erro quando uma branch existe em vários remotes.
wtp é gratuito? Qual é a licença?
wtp é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
wtp ainda é mantido?
Manutenção ativa. O último commit de wtp foi em 3 de nov. de 2026.
Para que posso usar wtp?
Trabalhar em várias branches de funcionalidades ao mesmo tempo sem guardar alterações com stash. Preparar novas worktrees com arquivos .env e instalação de dependências em projetos de microsserviços ou monorepos. Limpar branches de funcionalidades concluídas junto com suas worktrees.
Como instalar wtp?
Instale com Homebrew (macOS/Linux): brew install satococoa/tap/wtp Ou instale com Go: go install github.com/satococoa/wtp/v2/cmd/wtp@latest Crie um worktree com uma nova branch: wtp add -b feature/new-feature
Onde consigo wtp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/satococoa/wtp

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

Projetos relacionados