Mergetrain: Una cola de fusión local para sesiones paralelas de Claude Code que evita pushes pisoteados

Si ejecutas múltiples sesiones de Claude Code en paralelo, probablemente te hayas topado con el problema de pisadas: la rama A pasa las pruebas, la rama B pasa las pruebas, pero A-seguido-de-B falla. Los worktrees aislan la edición, pero no el aterrizaje. Y las reglas de CLAUDE.md como "nunca hacer push a main" se mantienen hasta que una sesión las rompe en el peor momento. Las reglas no son cumplimiento.

Mergetrain es una cola de fusión local que resuelve esto. Funciona completamente en tu máquina — sin servidor, sin GitHub App, sin servicio de CI, sin dependencias en tiempo de ejecución. Licencia MIT.

Cómo Funciona

• Cada sesión de Claude Code trabaja en su propio worktree y se encola en lugar de hacer push (mergetrain enqueue).
• Un hook pre-push propiedad del repo bloquea los pushes directos a main.
• Un ejecutor ensambla las ramas encoladas en un "tren" sobre origin/main, ejecuta gates (pruebas + una compilación completa de Unity) una vez sobre todo el tren, y luego hace push atómico.
• mergetrain hub sirve un panel de solo lectura para cada repo en la máquina: quién está ejecutando gates, qué está listo para enviar, qué necesita atención. Los agentes leen la misma información como JSON (hub status --json).
• Si tu portátil muere durante un push, mergetrain recover pregunta al remoto qué aterrizó realmente y lo reconcilia — nada se envía dos veces, nada mal etiquetado.
• Los repos que nunca deben ver despliegues desatendidos se pueden registrar con --no-daemon: visibles en el tablero, nunca barridos.

Primeros Pasos

Instala con pip: pip install mergetrain
Luego ejecuta mergetrain init para generar la configuración y un contrato CLAUDE.md que tus agentes recogen automáticamente.

Resultados de Dogfooding

Tres semanas en un juego comercial: 70+ trenes aterrizados, cero pushes pisados desde entonces.

¿Para Quién Es Esto?

Desarrolladores que ejecutan agentes de codificación de IA en paralelo (Claude Code, etc.) que necesitan una solución de integración local ligera sin depender de pipelines de PR alojados o bloqueo de archivos.