← Blog

How-to3 min read

1 つのリポジトリで 2 つのコーディングエージェントを動かす

同じチェックアウトで 2 つ目の Claude Code や Codex のセッションを動かすと、互いの変更を上書きしてしまいます。git worktree を使えば、Mirasim のどのセッションも専用の worktree で開始できます。

A Mirasim session with its own file tree and editor for the workspace it runs inA Mirasim session with its own file tree and editor for the workspace it runs in

2 つのエージェントが作業ツリーを共有すると何が起きるのか

1 つのリポジトリで 1 つのコーディングエージェントを動かすのは、もう難しいことではありません。しかし 2 つ同時となると話は別です。どちらのエージェントも相手の存在を知らないまま同じ作業ツリーで作業し、互いの変更を上書きしたり混ぜ合わせたりします。クラッシュは起きないため、失敗は気づきにくく、そのぶん厄介です。最終的に、どちらのエージェントも意図しておらず、誰にも説明できない diff が残ります。

  1. エージェント A がファイルを編集中

    2 つのエージェントが同じ作業ツリーを共有して作業

  2. エージェント B がブランチをチェックアウト

    エージェント A が書き換えたばかりのファイルを、エージェント B がステージすることも

  3. 書きかけの変更に対してテストが走る

    2 つの変更が混ざっても Git はエラーを出さない

  4. どちらのエージェントも意図しない diff ができあがる
エージェントごとにリポジトリをクローン
履歴が重複し、ブランチも分断される
エージェントを 1 つずつ順番に動かす
2 つのエージェントを使う意味がなくなる
それぞれに「このファイルだけ」と指示する
強制力がなく、エージェントが範囲を越えることもある

1 つのリポジトリで 2 つのエージェントを動かすときによく使われる 3 つの回避策(クローンを分ける、交代で動かす、触ってよいファイルを口頭で決める)は、どれも見た目以上に問題があります。

リンクされた worktree:1 つのリポジトリに独立したチェックアウトを複数持たせる

Git はバージョン 2.5 からこの問題への答えを用意しています。git worktree add を実行すると、同じオブジェクトデータベースと ref を共有する別の作業ディレクトリが作られます。2 つ目のリポジトリではなく、2 つ目のチェックアウトです。各 worktree はそれぞれ専用のブランチ上にあり、独自のインデックスと HEAD を持ちます。そのため、別々の worktree で作業する 2 つのエージェントは、相手のコミット前の変更を見ることも、相手のファイルをステージすることも、相手のブランチを切り替えることもできません。

共有される 1 つの Git リポジトリすべての worktree がオブジェクト、履歴、リモート、ブランチを共有
  • ../feature-a
    1. ブランチ feature-a をチェックアウトした worktree
    2. 独自のステージングインデックスと HEAD を持つ
    3. エージェント A はここで隔離された状態でファイルを編集
  • ../feature-b
    1. ブランチ feature-b をチェックアウトした worktree
    2. 独自のステージングインデックスと HEAD を持つ
    3. エージェント B はここで隔離された状態でファイルを編集
worktree 同士はコピーにコストのかかるものをすべて共有しているため、作業はマージ可能な状態に保たれます。エージェント A は 1 時間前にエージェント B が push した内容からブランチを切れますし、2 つの diff を同じベースに対してレビューできます。
ターミナルで手動でも同じ隔離を実現できます。コーディングエージェントごとに、リンクされた worktree とブランチを個別に作成します。
# one repository, two checkouts, two branches
git worktree add ../feature-a -b feature-a
git worktree add ../feature-b -b feature-b

# each has its own HEAD and index; the objects are shared
git worktree list

Mirasim がリンクされた worktree をセッションに組み込んでいる理由

worktree を手動で管理する場合
Mirasim のセッションの場合
worktree の作成
ブランチごとに git worktree add を 1 つずつ手動で実行
ベースブランチを選び、専用の worktree でセッションを開始
ブランチとファイルの把握
どのターミナルがどのブランチかを覚えておく必要がある
各ペインにその worktree のファイル、ターミナル、diff、コミットを表示
エージェントの隔離方法
他のディレクトリに触れないというルールを各エージェントが守ることが前提
各ペインがそれぞれ隔離された worktree ディレクトリで作業
エージェントの変更のマージ
diff をレビューし、ブランチを自分でマージ
diff のレビューとブランチのマージは引き続き自分で行う
worktree の手動管理は、ブランチが 2 つなら問題ありませんが、6 つになると手間がかかります。Mirasim なら、それぞれ専用の worktree で隔離された複数のセッションを同時に動かせます。

Mirasim の並行セッションとは、複数のコーディングエージェントが同時に、それぞれ別のタスクに取り組むことを指します。Mirasim は、1 つのタスクを複数のワーカーエージェントに振り分けるオーケストレーターではありません。ペインをまたいで計画を立てたり、コードを代わりにマージしたりする仕組みはなく、diff を並べてレビューし、マージは自分で行います。

Keep reading