Mergetrain: 並行するClaude Codeセッションのための、プッシュの競合を防ぐローカルマージキュー

複数のClaude Codeセッションを並行して実行している場合、おそらく次の問題に遭遇したことがあるでしょう：ブランチAはテストに合格、ブランチBもテストに合格、しかしAの後にBをマージすると壊れる。ワークツリーは編集を分離しますが、ランディングは分離しません。そして、「mainにプッシュしない」といったCLAUDE.mdのルールも、あるセッションが最悪のタイミングでそれを破るまでは機能します。ルールは強制ではありません。

Mergetrainはこの問題を解決するローカルマージキューです。サーバー不要、GitHub App不要、CIサービス不要、ランタイム依存関係なしで、完全にあなたのマシン上で動作します。MITライセンス。

仕組み

• 各Claude Codeセッションは自身のワークツリーで作業し、プッシュする代わりにエンキューします（mergetrain enqueue）。
• リポジトリ所有のプリプッシュフックが、mainへの直接プッシュをブロックします。
• 1つのランナーが、キューに入れられたブランチをorigin/mainの上に「トレイン」として組み立て、トレイン全体に対して一度だけゲート（テスト＋完全なUnityビルド）を実行し、アトミックにプッシュします。
• mergetrain hubは、マシン上のすべてのリポジトリに対して読み取り専用のダッシュボードを提供します：誰がゲートを実行しているか、何が出荷準備できているか、何が注意を必要としているか。エージェントは同じ情報をJSONとして読み取ります（hub status --json）。
• プッシュ中にラップトップがダウンした場合、mergetrain recoverがリモートに実際に何が着地したかを尋ねて調整します。何も二重に出荷されることはなく、誤ったラベルが付くこともありません。
• 無人デプロイを絶対に許可してはいけないリポジトリは、--no-daemonで登録できます：ボードには表示されますが、スイープされることはありません。

はじめに

pipでインストール：pip install mergetrain
次にmergetrain initを実行して、設定と、エージェントが自動的に読み取るCLAUDE.md契約書をスキャフォールディングします。

ドッグフーディングの結果

商用ゲームで3週間：70以上のトレインが着地し、それ以来プッシュの競合はゼロ。

誰のため？

ホストされたPRパイプラインやファイルロックに依存せず、軽量でローカルな統合ソリューションを必要とする、並行AIコーディングエージェント（Claude Codeなど）を実行する開発者向け。