Tres agentes, un repositorio y un choque inminente
Ejecutar múltiples agentes de IA en un solo checkout de Git es un choque a punto de ocurrir. El Agente A, a mitad de una refactorización, rompe repentinamente las pruebas del Agente B debido a dependencias compartidas o ediciones de archivos en conflicto. Este problema de carpeta compartida paraliza el desarrollo en paralelo.
Git worktrees ofrecen una solución inmediata: cada tarea obtiene un directorio aislado, su propia rama y un espacio de trabajo limpio. Este segundo checkout comparte el historial del repositorio, pero los agentes ya no escriben en la misma hoja de papel. Es una primitiva poderosa para paralelizar el trabajo.
Sin embargo, los Git worktrees básicos introducen su propia fricción. Crear uno requiere escribir el nombre de la rama tres veces, seguido de cambios manuales de directorio. La limpieza requiere otros tres comandos para eliminar el worktree y su rama.
Además, pedirle a Git el estado solo ofrece una lista estática de rutas de carpetas. No hay una vista única y dinámica de lo que está haciendo cada agente, no hay un comando de fusión integrado y las dependencias siguen siendo una preocupación manual. El soporte nativo de worktree, como el de Claude Code, soluciona la creación pero aún deja estas brechas críticas.
El flujo de trabajo de una sola línea que reemplaza el malabarismo con carpetas
Worktrunk simplifica los flujos de trabajo de agentes en paralelo al cambiar el enfoque de las rutas de carpetas a las ramas. wt switch <branch> crea o entra en un worktree, eliminando la necesidad de escribir nombres de ramas o recordar rutas de directorios. Este comando único configura un entorno aislado para cada agente.
wt list proporciona un panel interactivo y consolidado. Muestra cada worktree activo, indicando su rama, el progreso en relación con main, el tamaño de las diferencias y los indicadores de actividad del agente (por ejemplo, un icono de robot para agentes activos, un globo de texto para agentes que esperan entrada). Esto reemplaza las rutas de carpetas estáticas de git worktree list por un contexto accionable.
Cuando un agente termina su tarea, wt merge automatiza un ciclo de vida complejo de seis pasos de Git en un solo comando. Realiza el commit, squash, rebase sobre main, fast-forward y elimina el worktree terminado y su rama. Aunque wt merge automatiza la mayor parte del trabajo pesado, los conflictos aún detienen el rebase, lo que requiere intervención humana.
El truco de velocidad: reutilizar lo que cada agente necesita
Ejecutar múltiples agentes exige una configuración eficiente. Worktrunk proporciona hooks de ciclo de vida, ejecutando tareas de configuración automáticamente cuando se crea un worktree. Esto elimina las instalaciones repetidas de dependencias y la configuración manual del entorno, asegurando que cada agente comience siendo productivo.
Worktrunk también aborda el almacenamiento y la velocidad con wt step copy-ignored. Este comando reutiliza archivos ignorados como node_modules o cachés de compilación. En sistemas de archivos compatibles (APFS, Btrfs), emplea copy-on-write, vinculando a los archivos originales hasta que ocurren cambios. Esto ahorra una cantidad significativa de espacio en disco y tiempo.
El video demuestra resultados dramáticos: una carpeta de compilación de Rust de 14GB copiada en ~20 segundos con copy-ignored frente a 2 minutos normalmente. Una primera compilación de Rust bajó de 68 segundos a 3-4 segundos. Estos son tiempos reportados por el autor, no benchmarks universales. El soporte del sistema de archivos es crucial; EXT4 en Linux realiza copias completas. Además, los módulos nativos aún requieren reconstrucción. Para más detalles sobre el enfoque de Worktrunk para flujos de trabajo de agentes paralelos, consulte Worktrunk — Git worktree management for parallel AI agent workflows.
¿Te está gustando? Recibe uno así en tu bandeja cada mañana.
un correo al día · date de baja en dos clics · sin rastreadores de terceros
Útil, de rápido movimiento y no para todos los desarrolladores
La orquestación centrada en la terminal de Worktrunk contrasta notablemente con los worktrees nativos de Claude Code. Mientras que Claude Code maneja el aislamiento básico y la limpieza automática, deja el monitoreo de estado y los flujos de trabajo de fusión en manos del usuario. Worktrunk llena este vacío, ofreciendo una vista única de toda la actividad del agente y una fusión de un solo comando que gestiona commits, squashes, rebases y la eliminación de worktrees.
Esta pequeña CLI es anterior a la versión 1.0 (actualmente v0.81), lo que significa que los cambios disruptivos son frecuentes; espere tener que actualizar su configuración. Su configuración de función de shell para el cambio de directorios es crucial, al igual que revisar los hooks del proyecto que ejecutan comandos de shell. Los conflictos de fusión no resueltos aún requieren intervención manual; Worktrunk detiene el rebase y le devuelve el control a usted.
Los beneficios de copy-on-write de wt step copy-ignored dependen del sistema de archivos. En APFS, es casi instantáneo y ahorra un espacio significativo, pero en equipos con EXT4 Linux se realizan copias completas. Los módulos nativos aún necesitarán una reconstrucción en los nuevos worktrees.
Si ejecuta un agente a la vez, es probable que los worktrees nativos o Git simple sean suficientes. Sin embargo, si ejecuta regularmente tres, cinco o más agentes y necesita reducir la sobrecarga de los worktrees (desde la configuración y la instalación de dependencias hasta las comprobaciones de estado y la limpieza de fusiones), Worktrunk proporciona la capa de orquestación que falta.
Preguntas frecuentes
¿Qué es Worktrunk?
Worktrunk es una CLI de código abierto que simplifica la gestión de Git worktree para desarrolladores que ejecutan tareas de codificación paralelas o agentes de IA.
¿Cómo ayuda Worktrunk con los agentes de IA paralelos?
Le otorga a cada tarea su propia rama y checkout, muestra el estado del worktree en una sola vista y agiliza la fusión y la limpieza.
¿Worktrunk funciona solo con Claude Code?
No. Se integra con Claude Code y es compatible con otras CLI de agentes, incluyendo Codex, OpenCode y Gemini CLI.
¿Worktrunk elimina los conflictos de fusión?
No. Los worktrees aíslan los archivos durante el desarrollo, pero los cambios que se superponen aún pueden entrar en conflicto al fusionarse.
¿Está Worktrunk listo para producción?
Es una versión anterior a la 1.0, por lo que debe esperar posibles cambios disruptivos y revisar los hooks del proyecto antes de aprobar sus comandos de shell.