Repolode
Enviar
coderabbitai

coderabbitai/git-worktree-runner

Uma CLI em Bash que facilita o uso de git worktree para criar, configurar e remover worktrees por branch, com inicializadores de editores e agentes de IA.

Ver no GitHub
Estrelas
1,809
Forks
114
Issues abertas
11
Último commit
há 3 horas

O que é?

gtr (Git Worktree Runner) é uma ferramenta de linha de comando que facilita o uso de git worktrees. Um worktree permite fazer checkout de várias branches do mesmo repositório em pastas separadas ao mesmo tempo, para trabalhar em uma funcionalidade, revisar um pull request ou executar testes em main sem guardar alterações nem trocar de branch. O gtr oferece comandos mais curtos para as operações nativas de git worktree, como `git gtr new`, `git gtr pr 123` e `git gtr rm`.

Cada novo worktree pode ser configurado automaticamente. O gtr copia arquivos de configuração e de ambiente que correspondam a padrões definidos, executa hooks pós-criação, como a instalação de dependências, e pode abrir o worktree em um editor ou iniciar uma ferramenta de programação com IA. Os adaptadores integrados incluem editores como Cursor, VS Code e Zed e ferramentas de IA como Claude Code, Codex e Gemini CLI; qualquer outro comando seguro disponível no PATH também pode ser usado como alternativa. O modo de saída `--porcelain` oferece uma maneira estável para scripts e agentes de programação obterem o caminho do novo worktree.

As configurações são armazenadas no git config, com opções de padrões para toda a equipe em um arquivo `.gtrconfig`. Hooks e configurações padrão de editor ou IA definidos nesse arquivo só são executados após a aprovação do usuário com `git gtr trust`. A ferramenta funciona em macOS, Linux e Windows por meio do Git Bash ou WSL e requer Git 2.17+ e Bash 3.2+.

Recursos principais

  • 01Criar, listar, renomear e remover worktrees pelo nome da branch usando comandos curtos
  • 02Fazer checkout de pull requests em worktrees com `git gtr pr`
  • 03Copiar arquivos de ambiente e configuração para novos worktrees usando padrões de inclusão e exclusão
  • 04Executar hooks pós-criação, como a instalação de dependências
  • 05Abrir worktrees em editores compatíveis ou iniciar ferramentas de programação com IA usando adaptadores integrados
  • 06Remover worktrees associados a PRs ou MRs que foram mesclados ou fechados

Casos de uso

  • Revisar o pull request de alguém da equipe sem interromper o trabalho atual em uma funcionalidade
  • Executar vários agentes de programação com IA em paralelo, cada um em sua própria branch
  • Manter um worktree limpo em main para executar testes ou builds
  • Padronizar a configuração por branch, como arquivos de ambiente e instalação de dependências, em toda a equipe

Início rápido

  1. 1

    Instale pelo Homebrew (macOS)

    brew tap coderabbitai/tap && brew install git-gtr
  2. 2

    Ou clone o repositório

    git clone https://github.com/coderabbitai/git-worktree-runner.git
  3. 3

    Execute o instalador a partir do checkout

    ./install.sh
  4. 4

    Crie um worktree para uma branch

    git gtr new my-feature

Antes de usar

  • Requer Bash 3.2 ou posterior e Git 2.17 ou posterior; no Windows, há suporte apenas pelo Git Bash.
  • No Windows, o checkout completo precisa ser mantido no lugar, pois copiar apenas bin/git-gtr faz com que ele pare de funcionar.

Em coleções

Frameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IAFerramentas de CLI e terminal

Tópicos

#git#git-worktree#cli#bash#developer-workflow#ai-agents#code-review

Perguntas frequentes

O que é git-worktree-runner?
Uma CLI em Bash que facilita o uso de git worktree para criar, configurar e remover worktrees por branch, com inicializadores de editores e agentes de IA. gtr (Git Worktree Runner) é uma ferramenta de linha de comando que facilita o uso de git worktrees. Um worktree permite fazer checkout de várias branches do mesmo repositório em pastas separadas ao mesmo tempo, para trabalhar em uma funcionalidade, revisar um pull request ou executar testes em main sem guardar alterações nem trocar de branch. O gtr oferece comandos mais curtos para as operações nativas de git worktree, como `git gtr new`, `git gtr pr 123` e `git gtr rm`.
git-worktree-runner é gratuito? Qual é a licença?
git-worktree-runner é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
git-worktree-runner ainda é mantido?
Manutenção ativa. O último commit de git-worktree-runner foi em 6 de nov. de 2026.
Para que posso usar git-worktree-runner?
Revisar o pull request de alguém da equipe sem interromper o trabalho atual em uma funcionalidade Executar vários agentes de programação com IA em paralelo, cada um em sua própria branch Manter um worktree limpo em main para executar testes ou builds Padronizar a configuração por branch, como arquivos de ambiente e instalação de dependências, em toda a equipe
Como instalar git-worktree-runner?
Instale pelo Homebrew (macOS): brew tap coderabbitai/tap && brew install git-gtr Ou clone o repositório: git clone https://github.com/coderabbitai/git-worktree-runner.git Execute o instalador a partir do checkout: ./install.sh Crie um worktree para uma branch: git gtr new my-feature
Onde consigo git-worktree-runner?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/coderabbitai/git-worktree-runner

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

Projetos relacionados