Mergetrain: Uma Fila de Merge Local para Sessões Paralelas de Código Claude que Previne Pushes Sobrescritos

Se você está executando várias sessões do Claude Code em paralelo, provavelmente já passou pelo problema do atropelamento: a branch A passa nos testes, a branch B passa nos testes, mas A seguido de B quebra. Worktrees isolam a edição, mas não a finalização. E regras do CLAUDE.md como "nunca fazer push na main" se mantêm até que uma sessão as quebre no pior momento. Regras não são imposição.

Mergetrain é uma fila de merge local que resolve isso. Funciona inteiramente na sua máquina — sem servidor, sem GitHub App, sem serviço de CI, sem dependências de runtime. Licenciado sob MIT.

Como Funciona

• Cada sessão do Claude Code trabalha em seu próprio worktree e enfileira em vez de fazer push (mergetrain enqueue).
• Um hook pre-push pertencente ao repositório bloqueia pushes diretos para a main.
• Um executor único monta as branches enfileiradas em um "trem" sobre origin/main, executa gates (testes + uma build completa do Unity) uma vez sobre o trem inteiro e então faz push atômico.
• mergetrain hub serve um painel somente leitura para cada repositório na máquina: quem está executando gates, o que está pronto para enviar, o que precisa de atenção. Agentes leem as mesmas informações como JSON (hub status --json).
• Se seu laptop morrer durante o push, mergetrain recover pergunta ao remoto o que realmente foi enviado e reconcilia — nada é enviado duas vezes, nada é rotulado incorretamente.
• Repositórios que nunca devem ver deploys não supervisionados podem ser registrados com --no-daemon: visíveis no painel, nunca varridos.

Primeiros Passos

Instale com pip: pip install mergetrain
Depois execute mergetrain init para montar a configuração mais um contrato CLAUDE.md que seus agentes capturam automaticamente.

Resultados do Dogfooding

Três semanas em um jogo comercial: mais de 70 trens enviados, zero pushes atropelados desde então.

Para Quem É Isso?

Desenvolvedores executando agentes de IA de codificação paralelos (Claude Code, etc.) que precisam de uma solução de integração local e leve, sem depender de pipelines de PR hospedados ou bloqueio de arquivos.