Tutorial 15: Git Worktrees — Agentes Paralelos

Esto es parte de la serie oficial de tutoriales de Hermes Agent. Ver todos los tutoriales

Imagina que tienes una cocina pero dos chefs. Si ambos cocinan en la misma encimera, se chocarán los codos, derramarán harina y arruinarán los platos del otro. Los worktrees de Git le dan a cada chef su propia encimera: misma cocina, pero espacios de trabajo separados. Eso es exactamente lo que esta función hace por tus agentes de IA.

¿Por qué molestarse? El problema con un solo checkout

Hermes Agent trata la carpeta donde lo ejecutas como la raíz del proyecto. Si lanzas dos agentes en la misma carpeta, comparten cada archivo. Eso significa que:

El Agente A podría borrar un archivo que el Agente B está editando.
No puedes saber qué cambios vienen de qué experimento.
Los rollbacks se vuelven un desastre: el deshacer de un agente podría borrar el trabajo del otro.

Los worktrees resuelven esto dándole a cada agente:

Su propia rama (para que los cambios no colisionen)
Su propia carpeta de trabajo (para que los archivos no choquen)
Su propio historial de checkpoints (para que /rollback solo afecte a ese agente)

Paso 1: Crear un worktree (El comando básico)

Desde tu repositorio principal (el que tiene .git/ adentro), ejecuta:

git worktree add ../my-agent-folder -b my-feature-branch

Vamos a desglosarlo:

../my-agent-folder – dónde vivirá la nueva carpeta (fuera de tu repo principal)
-b my-feature-branch – crea una nueva rama para este agente

Ahora tienes una copia fresca y aislada de tu proyecto.

Paso 2: Apuntar Hermes al worktree

Puedes usar el worktree de dos maneras:

Opción A: CLI (la más simple)
Solo haz cd al worktree y ejecuta Hermes allí:

cd ../my-agent-folder
hermes chat

Opción B: Pasarelas de mensajería (como Slack o Discord)
Si usas una pasarela, edita ~/.hermes/config.yaml y configura terminal.cwd con la ruta del worktree:

terminal:
  cwd: /path/to/my-agent-folder

Ahora cada mensaje que reciba ese agente trabajará dentro de esa carpeta aislada.

Paso 3: Ejecutar múltiples agentes en paralelo

Crea tantos worktrees como necesites:

git worktree add ../agent-experiment-1 -b exp-1
git worktree add ../agent-experiment-2 -b exp-2

Luego inicia una sesión de Hermes en cada carpeta. Nunca tocarán los archivos del otro, y cada uno tiene su propia rama para hacer commits.

Paso 4: Limpiar cuando termines

Cuando un experimento haya terminado, elimina el worktree:

git worktree remove ../agent-experiment-1
git branch -d exp-1

El primer comando borra la carpeta; el segundo borra la rama. Tu repo principal queda limpio.

Puntos clave para recordar

Los worktrees son baratos – no copian todo el repo, solo los archivos que necesitas.
Cada agente tiene su propio historial de /rollback – se acabaron los desastres de deshacer entre agentes.
Usa las ramas con sabiduría – nómbralas claramente (ej., refactor-login, fix-bug-42) para saber qué hizo cada agente.

Resumen

Los worktrees de Git te permiten ejecutar múltiples agentes de Hermes en el mismo proyecto sin que se pisen los pies. Crea un worktree por agente, apunta Hermes a él, y listo. Es como darle a cada chef su propia tabla de cortar: misma cocina, cero colisiones.