Repolode
k1LoW

k1LoW/git-wt

Un subcomando de Git que simplifica `git worktree`: permite cambiar, crear, eliminar y renombrar worktrees por nombre de rama o directorio.

Estrellas
562
Forks
25
Issues abiertos
12
Último commit
hace 23 días

¿Qué es?

git-wt es un subcomando de Git que ofrece una interfaz más breve para `git worktree`. Al ejecutar `git wt <branch>`, se cambia a un worktree existente o se crea uno, incluida la rama si todavía no existe. Los worktrees se pueden listar (con salida JSON opcional), eliminar y renombrar, cambiando a la vez el directorio y la rama.

La herramienta se encarga de tareas habituales de configuración al crear un worktree. Puede copiar archivos ignorados por Git, sin seguimiento o modificados, o crear symlinks a directorios grandes, como node_modules, en lugar de duplicarlos. Se pueden ejecutar comandos mediante hooks después de la creación, como instalar dependencias, y hay hooks independientes que se ejecutan antes de eliminarlo. La configuración se realiza con git config y la mayoría de las opciones se pueden sobrescribir en cada ejecución.

La integración con zsh, bash, fish y PowerShell permite cambiar de directorio automáticamente y completar comandos con tabulador. La eliminación segura impide borrar worktrees con cambios sin confirmar, y protege la rama predeterminada para evitar que se elimine por accidente.

Funciones clave

  • 01Cambiar a un worktree o crear uno junto con su rama mediante un único comando: `git wt <branch>`.
  • 02Eliminar de forma segura, conservando los cambios sin confirmar y las ramas sin fusionar, con una opción para forzar la eliminación.
  • 03Renombrar a la vez el directorio del worktree y su rama.
  • 04Copiar archivos ignorados, sin seguimiento o modificados, o crear symlinks a ellos en los worktrees nuevos.
  • 05Ejecutar hooks después de la creación o antes de la eliminación.
  • 06Integración con zsh, bash, fish y PowerShell, con autocompletado.

Casos de uso

  • Trabajar en varias ramas a la vez sin guardar los cambios con stash ni cambiar de rama en un mismo checkout.
  • Revisar un pull request en un directorio separado sin alterar el trabajo actual.
  • Compartir directorios grandes de dependencias entre worktrees mediante symlinks para ahorrar espacio en disco y tiempo de configuración.
  • Integrar el cambio entre worktrees con fzf, peco o tmux para elegir de forma interactiva.

Inicio rápido

  1. 1

    Instalar con Go

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

    O instalar con Homebrew

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

    Mostrar los worktrees del repositorio

    git wt
  4. 4

    Cambiar a un worktree para una rama o crear uno

    git wt feature-branch

Antes de usarlo

  • La integración con el shell para cambiar de directorio automáticamente está marcada como experimental para bash, fish y PowerShell.

En colecciones

Temas

Preguntas frecuentes

¿Qué es git-wt?
Un subcomando de Git que simplifica `git worktree`: permite cambiar, crear, eliminar y renombrar worktrees por nombre de rama o directorio. git-wt es un subcomando de Git que ofrece una interfaz más breve para `git worktree`. Al ejecutar `git wt <branch>`, se cambia a un worktree existente o se crea uno, incluida la rama si todavía no existe. Los worktrees se pueden listar (con salida JSON opcional), eliminar y renombrar, cambiando a la vez el directorio y la rama.
¿git-wt es gratuito? ¿Qué licencia tiene?
git-wt es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿git-wt sigue mantenido?
Mantenimiento activo. El último commit de git-wt fue el 15 oct 2026.
¿Para qué puedo usar git-wt?
Trabajar en varias ramas a la vez sin guardar los cambios con stash ni cambiar de rama en un mismo checkout. Revisar un pull request en un directorio separado sin alterar el trabajo actual. Compartir directorios grandes de dependencias entre worktrees mediante symlinks para ahorrar espacio en disco y tiempo de configuración. Integrar el cambio entre worktrees con fzf, peco o tmux para elegir de forma interactiva.
¿Cómo se instala git-wt?
Instalar con Go: go install github.com/k1LoW/git-wt@latest O instalar con Homebrew: brew install k1LoW/tap/git-wt Mostrar los worktrees del repositorio: git wt Cambiar a un worktree para una rama o crear uno: git wt feature-branch
¿Dónde consigo git-wt?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/k1LoW/git-wt

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

Proyectos relacionados