Repolode
Enviar
coderabbitai

coderabbitai/git-worktree-runner

Una CLI de Bash que facilita el uso de git worktree para crear, configurar y eliminar worktrees por rama, con opciones para abrir editores y agentes de IA.

Ver en GitHub
Estrellas
1,809
Forks
114
Issues abiertos
11
Último commit
hace 21 horas

¿Qué es?

gtr (Git Worktree Runner) es una herramienta de línea de comandos que facilita el uso de git worktree. Un worktree permite tener varias ramas del mismo repositorio en carpetas independientes al mismo tiempo, para trabajar en una funcionalidad, revisar un pull request o ejecutar pruebas en main sin guardar cambios con stash ni cambiar de rama. gtr simplifica los comandos de git worktree con otros más breves, como `git gtr new`, `git gtr pr 123` y `git gtr rm`.

Cada worktree nuevo se puede configurar automáticamente. gtr copia archivos de configuración y de entorno que coincidan con los patrones configurados, ejecuta hooks posteriores a la creación —por ejemplo, para instalar dependencias— y puede abrir el worktree en un editor o iniciar una herramienta de programación con IA. Incluye adaptadores para editores como Cursor, VS Code y Zed, y herramientas de IA como Claude Code, Codex y Gemini CLI. También se puede usar como alternativa cualquier otro comando seguro disponible en PATH. El modo de salida `--porcelain` ofrece a los scripts y agentes de programación una forma estable de obtener la ruta del worktree nuevo.

La configuración se guarda en git config, con valores predeterminados opcionales para todo el equipo en un archivo `.gtrconfig`. Los hooks y los valores predeterminados de editor o IA definidos en ese archivo solo se ejecutan cuando el usuario los aprueba con `git gtr trust`. La herramienta funciona en macOS, Linux y Windows mediante Git Bash o WSL, y requiere Git 2.17+ y Bash 3.2+.

Funciones clave

  • 01Crear, listar, renombrar y eliminar worktrees por nombre de rama con comandos breves
  • 02Obtener pull requests en worktrees con `git gtr pr`
  • 03Copiar archivos de entorno y configuración en los worktrees nuevos mediante patrones de inclusión y exclusión
  • 04Ejecutar hooks posteriores a la creación, como la instalación de dependencias
  • 05Abrir worktrees en editores compatibles o iniciar herramientas de programación con IA mediante adaptadores integrados
  • 06Limpiar worktrees cuyas PR o MR se hayan fusionado o cerrado

Casos de uso

  • Revisar el pull request de un compañero sin interrumpir el trabajo actual en una funcionalidad
  • Ejecutar varios agentes de programación con IA en paralelo, cada uno en su propia rama
  • Mantener un worktree limpio en main para ejecutar pruebas o compilaciones
  • Estandarizar en todo el equipo la configuración de cada rama, como los archivos de entorno y la instalación de dependencias

Inicio rápido

  1. 1

    Instala con Homebrew (macOS)

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

    O clona el repositorio

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

    Ejecuta el instalador desde el checkout

    ./install.sh
  4. 4

    Crea un worktree para una rama

    git gtr new my-feature

Antes de usarlo

  • Requiere Bash 3.2 o posterior y Git 2.17 o posterior; Windows solo es compatible mediante Git Bash.
  • En Windows, debes conservar el checkout completo, ya que copiar solo bin/git-gtr hace que deje de funcionar.

En colecciones

Frameworks y apps de agentes de IA open sourceAsistentes y agentes de programación con IAHerramientas de CLI y terminal

Temas

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

Preguntas frecuentes

¿Qué es git-worktree-runner?
Una CLI de Bash que facilita el uso de git worktree para crear, configurar y eliminar worktrees por rama, con opciones para abrir editores y agentes de IA. gtr (Git Worktree Runner) es una herramienta de línea de comandos que facilita el uso de git worktree. Un worktree permite tener varias ramas del mismo repositorio en carpetas independientes al mismo tiempo, para trabajar en una funcionalidad, revisar un pull request o ejecutar pruebas en main sin guardar cambios con stash ni cambiar de rama. gtr simplifica los comandos de git worktree con otros más breves, como `git gtr new`, `git gtr pr 123` y `git gtr rm`.
¿git-worktree-runner es gratuito? ¿Qué licencia tiene?
git-worktree-runner es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿git-worktree-runner sigue mantenido?
Mantenimiento activo. El último commit de git-worktree-runner fue el 7 nov 2026.
¿Para qué puedo usar git-worktree-runner?
Revisar el pull request de un compañero sin interrumpir el trabajo actual en una funcionalidad Ejecutar varios agentes de programación con IA en paralelo, cada uno en su propia rama Mantener un worktree limpio en main para ejecutar pruebas o compilaciones Estandarizar en todo el equipo la configuración de cada rama, como los archivos de entorno y la instalación de dependencias
¿Cómo se instala git-worktree-runner?
Instala con Homebrew (macOS): brew tap coderabbitai/tap && brew install git-gtr O clona el repositorio: git clone https://github.com/coderabbitai/git-worktree-runner.git Ejecuta el instalador desde el checkout: ./install.sh Crea un worktree para una rama: git gtr new my-feature
¿Dónde consigo git-worktree-runner?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/coderabbitai/git-worktree-runner

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados