Mergetrain : une file d'attente de fusion locale pour les sessions Claude Code parallèles qui empêche les poussées écrasées

Si vous exécutez plusieurs sessions Claude Code en parallèle, vous avez probablement rencontré le problème d'écrasement : la branche A réussit les tests, la branche B aussi, mais A-puis-B casse tout. Les worktrees isolent l'édition, pas l'atterrissage. Et les règles CLAUDE.md comme "ne jamais pusher sur main" tiennent jusqu'à ce qu'une session les brise au pire moment. Les règles ne sont pas une application.

Mergetrain est une file d'attente de fusion locale qui résout ce problème. Il s'exécute entièrement sur votre machine — pas de serveur, pas d'application GitHub, pas de service CI, pas de dépendances d'exécution. Sous licence MIT.

Comment ça marche

• Chaque session Claude Code travaille dans son propre worktree et se met en file d'attente au lieu de pusher (mergetrain enqueue).
• Un hook pré-push appartenant au dépôt bloque les pushs directs vers main.
• Un exécuteur unique assemble les branches en file d'attente en un "train" au-dessus de origin/main, exécute les barrières (tests + une build Unity complète) une fois sur l'ensemble du train, puis pousse atomiquement.
• mergetrain hub sert un tableau de bord en lecture seule pour chaque dépôt sur la machine : qui exécute des barrières, ce qui est prêt à être livré, ce qui nécessite attention. Les agents lisent les mêmes informations en JSON (hub status --json).
• Si votre ordinateur portable meurt en plein push, mergetrain recover demande au distant ce qui a réellement atterri et réconcilie — rien n'est livré deux fois, rien n'est mal étiqueté.
• Les dépôts qui ne doivent jamais voir de déploiements non supervisés peuvent être enregistrés avec --no-daemon : visibles sur le tableau, jamais balayés.

Pour commencer

Installez avec pip : pip install mergetrain
Exécutez ensuite mergetrain init pour générer la configuration ainsi qu'un contrat CLAUDE.md que vos agents récupèrent automatiquement.

Résultats de dogfooding

Trois semaines sur un jeu commercial : plus de 70 trains livrés, zéro push écrasé depuis.

À qui cela s'adresse-t-il ?

Développeurs exécutant des agents de codage IA parallèles (Claude Code, etc.) qui ont besoin d'une solution d'intégration légère et locale sans dépendre de pipelines PR hébergés ou de verrouillage de fichiers.