Cómo ejecutar sesiones de Claude Code, Codex y OpenCode en paralelo con Git worktrees (desde el móvil)
Un flujo de trabajo práctico para aislar tareas en worktrees, ejecutar sesiones de Claude Code, Codex y OpenCode en paralelo y revisar y hacer commit con seguridad desde el móvil, todo desde un mismo sitio.
- CLI
- 0.2.17
- Ref de preview
- a2c45c8
Lo que hace útiles los worktrees aquí no es que "puedas tener dos ramas a la vez".
Es el trabajo con varios agentes.
Cuando ejecutas dos sesiones en la misma carpeta, los fallos son previsibles:
- los agentes tocan los mismos archivos
- los diffs se enredan
- pierdes el hilo de qué pertenece a cada tarea
Una regla sencilla resuelve casi todo:
un worktree por tarea
Así, si quieres:
- una sesión de Claude Code con una refactorización
- una sesión de Codex con los tests
- una sesión de OpenCode con la documentación
puedes hacerlo en paralelo sin pisarte.
Esta guía explica ese flujo de trabajo.
Definición rápida: qué es un worktree (y por qué ayuda con agentes)
La documentación de Git describe un worktree como una forma de gestionar varios árboles de trabajo vinculados al mismo repositorio, para tener más de una rama a la vez. (Fuente: https://git-scm.com/docs/git-worktree)
Para el trabajo con varios agentes, lo importante es más sencillo:
- cada worktree es una carpeta aislada
- cada agente tiene su propia carpeta
Así, "¿qué agente cambió este archivo?" se responde mirando el directorio, no con una investigación.
Enfoques habituales y dónde fallan
- Una rama, una carpeta, agentes uno detrás de otro: seguro, pero lento.
- Una carpeta, varios agentes: rápido, pero desordenado.
- Hacer stash y recuperarlo entre tareas: se puede, pero es propenso a errores cuando lo haces a menudo.
Los worktrees fueron lo primero que resultó rápido y seguro a la vez.
Un flujo de trabajo que funciona
Este flujo usa Happier como centro de control. Happier es una app de código abierto para ejecutar y orquestar Claude Code, Codex y otros agentes entre dispositivos.
Te da dos cosas en un mismo sitio:
- Sesiones: inicia y sigue sesiones de Claude Code, Codex y OpenCode entre dispositivos
- Archivos y Git por sesión: cada sesión está ligada a una carpeta, así que sus pestañas Archivos (Files) y Git muestran esa carpeta y nada más
Contrapartida: tu ordenador tiene que estar conectado.
Si no conoces Happier (qué es y dónde conseguirlo)
Happier es una app complementaria de código abierto (móvil, web y escritorio) que te permite ejecutar sesiones en un ordenador de confianza y gestionarlas desde el móvil.
Para empezar:
- GitHub: https://github.com/happier-dev/happier
- Instalación y descarga: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg
El patrón: un worktree por tarea
Una versión sencilla:
- crea un worktree para la tarea A
- crea un worktree para la tarea B
- ejecuta una sesión en cada uno
- revisa y haz commit de cada worktree por separado
Si te quedas con una sola cosa de esta guía, que sea esta.
Paso a paso
1) Elige las tareas que de verdad quieres en paralelo
El paralelismo es una herramienta.
Buenas tareas para paralelizar:
- tests frente a documentación
- refactorización frente a un ajuste pequeño de la interfaz
- arreglar un bug frente a escribir un plan de migración
Malas tareas para paralelizar:
- dos agentes editando el mismo conjunto de archivos centrales
2) Crea los worktrees
Con Git a pelo, usarías git worktree add ... para crear worktrees vinculados. (Fuente: https://git-scm.com/docs/git-worktree)
En la práctica, lo que importa es el resultado:
- dos carpetas, cada una con su propia rama
3) Inicia una sesión por cada carpeta de worktree
En Happier, inicia una sesión nueva de Claude Code, Codex u OpenCode y elige la carpeta del worktree como directorio de trabajo. Haz lo mismo con el segundo worktree.
Como cada sesión está ligada a su carpeta, la pestaña Git de cada sesión es una vista por worktree de diffs, commits y pushes que no mezcla cambios.
El hábito que lo mantiene limpio:
- pon a la sesión el nombre del worktree o de la tarea
- acota la sesión ("toca solo archivos de este worktree")
4) Sigue las sesiones desde un solo sitio
Cuando hay varias sesiones en marcha, el objetivo no es leer todas las transcripciones.
Es:
- ver qué sesiones están activas
- gestionar las aprobaciones
- enviar un mensaje de seguimiento
Y cuando algo termina:
- abre la pestaña Git de esa sesión
- revisa el diff
- haz commit y push (las acciones de escritura de Git son experimentales y vienen desactivadas, consulta la documentación de Git)
5) Revisa y haz commit por worktree
Tu regla de seguridad:
- nunca metas en un mismo commit cambios de varios worktrees
Si lo haces, pierdes la ventaja del aislamiento.
Terminal (opcional)
Las sesiones pueden mostrar una pestaña Terminal cuando la terminal integrada está disponible. Es experimental según la matriz de funciones.
Úsala para comandos sueltos (grep, un status rápido), no como flujo principal.
Preguntas frecuentes
¿Por qué no usar solo ramas sin worktrees?
Porque cambiar de rama en una sola carpeta te obliga a recurrir a stash o a commits WIP.
Los worktrees te dejan el trabajo donde está.
¿Necesito un agente por worktree?
No siempre.
Pero si ejecutas agentes en paralelo, un agente por worktree es la forma sencilla de evitar choques.
¿Cuál es el error típico?
Crear worktrees… y seguir ejecutando varios agentes en la misma carpeta.
El aislamiento solo funciona si lo usas de verdad.
¿Qué nombres pongo a los worktrees y las sesiones?
Que se entiendan solos en la pantalla del móvil.
- worktree:
hotfix-<ticket>/docs-<topic>/tests-<area> - sesión: el mismo nombre que el worktree, más el agente (por ejemplo, "hotfix-123 (Codex)")
¿Cuántas sesiones en paralelo son "demasiadas"?
No va del número, sino de si todavía puedes revisar con seguridad.
Un buen punto de partida son 2 o 3 sesiones en paralelo:
- una con el cambio principal
- una con una tarea secundaria (tests o documentación)
- opcionalmente una haciendo revisión o comprobaciones
¿Cómo evito que los agentes toquen el worktree equivocado?
Dos hábitos ayudan mucho:
- Pon el nombre del worktree en el primer mensaje: "Trabaja solo en
<worktree-name>." - Pide un resumen de control después de los primeros pasos.
Si no estás delante del teclado, merece la pena ser explícito.
¿Cuál es la "rutina desde el móvil" cuando hay varias sesiones en marcha?
Una rutina sencilla:
- abre Happier
- mira qué sesiones están activas
- gestiona las aprobaciones
- envía un seguimiento corto (o "para y resume")
- cuando una sesión termine, revisa el diff de su worktree y haz commit
El objetivo es mantener el control sin intentar programar a fondo desde el móvil.
¿Cómo reviso con seguridad el trabajo de cada agente?
Trata cada worktree como su propia unidad de revisión y commit.
- Control de versiones (Source control) → Archivos modificados (Changed files) → ↓ Revisión (Review)
- haz commit con un mensaje acotado
- haz push solo cuando estés seguro
¿Y si dos agentes necesitan tocar el mismo archivo?
En ese punto, el paralelismo ayuda menos.
Opciones:
- hacer el trabajo en secuencia (primero el agente A, luego el B)
- dividir las tareas para que toquen partes distintas del código
- o que un agente haga el cambio y el otro lo revise
¿Esto solo sirve desde el móvil?
No, pero desde el móvil es especialmente útil.
Los worktrees mantienen ordenado el sistema de archivos.
Happier te permite seguir las sesiones, revisar y hacer commit desde el mismo sitio, estés en el móvil, el escritorio o la web.