Repolode
satococoa

satococoa/wtp

Una CLI de Git worktree que genera rutas a partir de nombres de ramas, ejecuta hooks de configuración y elimina worktrees junto con sus ramas.

Estrellas
636
Forks
25
Issues abiertos
27
Último commit
hace 4 días

¿Qué es?

wtp (Worktree Plus) es una herramienta de línea de comandos que añade funciones prácticas a git worktree para gestionar varias ramas activas en paralelo. Al ejecutar wtp add feature/auth, crea un worktree en una ruta derivada del nombre de la rama, por lo que no hace falta escribir rutas relativas largas a mano. También puede hacer checkout automáticamente de ramas que solo existen en remotos y muestra un error si una rama existe en varios remotos.

La herramienta permite configurar cada proyecto mediante un archivo .wtp.yml. Los hooks posteriores a la creación pueden copiar archivos ignorados por Git, como .env, desde el worktree principal; crear enlaces simbólicos a directorios compartidos, como .bin; y ejecutar comandos de configuración, como npm ci o migraciones de base de datos. wtp remove --with-branch elimina un worktree y su rama en un solo paso, y wtp cd permite ir a un worktree por su nombre, con autocompletado con la tecla Tab en Bash, Zsh y Fish.

wtp está escrito en Go y se distribuye mediante Homebrew, go install y binarios precompilados para Linux y macOS. Requiere Git 2.17 o posterior.

Funciones clave

  • 01Genera automáticamente rutas de worktree a partir de los nombres de las ramas.
  • 02Elimina un worktree y su rama con wtp remove --with-branch.
  • 03Ejecuta hooks posteriores a la creación para copiar archivos, crear enlaces simbólicos y ejecutar comandos de configuración.
  • 04Hace seguimiento automático de ramas remotas cuando no existe una rama local.
  • 05Incluye wtp cd con autocompletado con la tecla Tab en Bash, Zsh y Fish.

Casos de uso

  • Trabajar a la vez en varias ramas de funcionalidades sin guardar los cambios temporalmente con stash.
  • Preparar nuevos worktrees con archivos .env e instalación de dependencias en proyectos de microservicios o monorepos.
  • Eliminar ramas de funcionalidades terminadas junto con sus worktrees.

Inicio rápido

  1. 1

    Instálalo con Homebrew (macOS/Linux)

    brew install satococoa/tap/wtp
  2. 2

    O instálalo con Go

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

    Crea un worktree con una rama nueva

    wtp add -b feature/new-feature

Antes de usarlo

  • Requiere Git 2.17 o posterior.
  • Solo se ofrecen binarios precompilados para macOS con Apple Silicon y Linux; no para Mac con Intel ni Windows.

En colecciones

Temas

Preguntas frecuentes

¿Qué es wtp?
Una CLI de Git worktree que genera rutas a partir de nombres de ramas, ejecuta hooks de configuración y elimina worktrees junto con sus ramas. wtp (Worktree Plus) es una herramienta de línea de comandos que añade funciones prácticas a git worktree para gestionar varias ramas activas en paralelo. Al ejecutar wtp add feature/auth, crea un worktree en una ruta derivada del nombre de la rama, por lo que no hace falta escribir rutas relativas largas a mano. También puede hacer checkout automáticamente de ramas que solo existen en remotos y muestra un error si una rama existe en varios remotos.
¿wtp es gratuito? ¿Qué licencia tiene?
wtp es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿wtp sigue mantenido?
Mantenimiento activo. El último commit de wtp fue el 3 nov 2026.
¿Para qué puedo usar wtp?
Trabajar a la vez en varias ramas de funcionalidades sin guardar los cambios temporalmente con stash. Preparar nuevos worktrees con archivos .env e instalación de dependencias en proyectos de microservicios o monorepos. Eliminar ramas de funcionalidades terminadas junto con sus worktrees.
¿Cómo se instala wtp?
Instálalo con Homebrew (macOS/Linux): brew install satococoa/tap/wtp O instálalo con Go: go install github.com/satococoa/wtp/v2/cmd/wtp@latest Crea un worktree con una rama nueva: wtp add -b feature/new-feature
¿Dónde consigo wtp?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/satococoa/wtp

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

Proyectos relacionados