エージェントを10個並列で走らせると、先に壊れるのはGitリポジトリのほう

コーディングエージェントの売り文句は今年ずっと同じでした。無人で走るのだから、同時にいくつも走らせればいい。5個でも10個でも、もっとでも。ひとつは認証まわりのリファクタリング、ひとつは不安定なテスト、ひとつは誰も触りたくないマイグレーション。
ツールはおおむね持ちこたえます。それから実際に試すと、壊れるのは作業ディレクトリのほうだと分かります。
同じチェックアウトで2つのエージェントを動かせば、1分も経たずに互いのファイルを上書きします。答えは2015年からgitにあります。worktreeです。各ブランチに独自のディレクトリを与えながら、オブジェクトデータベースは1つを共有します。gitにはできます。ただ、そのためのgitのインターフェースがひどいので、ほとんどの人は使ったことがありません。
Worktrunkはそのインターフェースを直すRust製のCLIです。11,900スター、うち約2,200はこの1週間で付きました。ライセンスはMITかApache-2.0で、好みのほうを選べます。
3回タイプする問題
gitでworktreeを作るには、ブランチ名を3回タイプする必要があります。
git worktree add -b feat ../repo.feat cd ../repo.feat
3つのうち2つは冗長です。コマンドがパスとブランチを要求し、パスはほぼ必ずブランチから導けるからこうなっています。小さな煩わしさに聞こえます。これが、worktreeが既定の手法ではなく、強いこだわりを持つ人のテクニックにとどまった理由です。
Worktrunkはworktreeをブランチ名で扱い、パスは設定可能なテンプレートから計算します。ブランチを受け取るコマンドは、そのブランチを持つworktreeのパスも受け取ります。すると、あの気まずい3行の踊りはこうなります。
wt switch -c -x claude feat
ブランチを作り、そのworktreeを作り、その中でClaudeを起動します。どこにいても。-x フラグは切り替え後にコマンドを実行します。区切り文字の後ろに付けたものはそのコマンドに渡され、これがエージェントに最初の指示を渡す方法です。
wt switch -x claude -c feature-auth
これを1つのシェルで3回打てば、3つのブランチに3つのエージェント、互いに隔離され、あいだに調整は一切ありません。
インストール
macOSかLinuxならHomebrewです。brew install worktrunk && wt config shell install。Cargo、pacman、conda-forge、pixiも使えます。Windowsではwinget install max-sixty.worktrunk、続けてgit-wt config shell installです。
Windowsの話は繰り返す価値があります。誰かが必ず引っかかるからです。wtはすでにWindows Terminalが使っているので、Wingetは衝突を避けてgit-wtという名前でインストールします。アプリ実行エイリアスでWindows Terminalのエイリアスを無効にすれば、wtをそのまま使うこともできます。
config shell installの手順は任意ではありません。コマンドが現在のディレクトリを変えられるようにするシェルフックを入れる工程で、これがwt switchの仕組みそのものです。飛ばすと、どのコマンドも何もしていないように見えます。
重要なコマンド
4つでワークフローの大半をカバーできます。
wt switch は移動します。wt list はすべてのworktreeを状態マーカー付きで表示します。@ は現在地、+ はステージ済みの変更、↑1 はmainより1コミット先行、⇡ は未プッシュのコミット。この出力だけでgit worktree listよりましです。あちらはパスしか返しません。
wt remove は片付けます。worktreeとブランチをまとめて削除するので、gitでは2つのコマンドになる作業が、間違えやすい1か所に収まります。
wt merge main が面白いほうです。現在のブランチをsquashし、mainにrebaseし、fast-forwardし、worktreeを削除します。ひとつの手順で。3つの並列ブランチで同じコンフリクトを3回解いたことがある人なら、これがなぜあるか分かるはずです。並列化はマージ問題を増幅します。そしてマージ問題はもともとこの仕事でいちばん愉快でない部分でした。
wt switch pr:123 もあります。プルリクエストの背後にあるブランチへ直接飛びます。小さな機能で、釣り合わないほど効く改善です。
ストレージは誰も警告してくれない部分
worktreeが10個なら、node_modulesが10個、target/が10個です。ノートPCでは数百ギガバイトになり、それぞれで最初のcargo buildに4分かかります。
Worktrunkはこれをコピーオンライトのビルドキャッシュで処理します。対応しているファイルシステム、macOSのAPFS、Linuxのreflink対応btrfsとXFSでは、worktreeがビルドディレクトリを共有し、ファイルが変わったときだけ分岐します。最初のビルドが代金を払い、次の9個は借りるだけです。
この種の機能は、作者が実際に何にツールを使っているかを露呈します。マーケティングのためにworktree管理ツールに共有ビルドキャッシュを足す人はいません。ディスクが埋まるのが4回目になってから足すのです。
関連する細部がhash_portです。各worktreeに固有のポートを与えるテンプレートフィルタです。10個のworktree、10個の開発サーバー、ポート衝突なし、手作業の管理もなし。依存関係をインストールしてサーバーを起動するpost-startフックと組み合わせれば、新しいworktreeはエージェントが動き出した瞬間に完全に使える状態になります。
フックは刃の側
フックは決められた時点でシェルコマンドを自動実行します。worktreeの起動後、マージの前、マージの後。post-startフックは環境構築をタダで手に入れる方法です。
同時に、gitの操作で起動する任意コード実行でもあります。リポジトリはwt switchで何かを走らせる設定を同梱でき、あなたがそれをcloneしてブランチに切り替えれば、それは実行されます。npm installがpostinstallスクリプトを走らせるのと同じ種類のリスクで、同じ扱いを受けるべきです。リポジトリを信頼する前に設定を読むこと。
これに対するツール自身の答えは、フックは自分が管理する設定で宣言される、というものです。それが十分かどうかは脅威モデル次第で、見知らぬリポジトリをcloneする人なら一度考えてみる価値があります。
直らないもの
worktreeは1つの.gitディレクトリを共有するので、ブランチ参照、stash、設定も共有します。2つのエージェントは同じブランチをチェックアウトできません。あるworktreeでのgit rebaseは、別のworktreeが座っている履歴を変えます。reflogのエントリは、事後の調査を難しくする形で混ざり合います。
Worktrunkはよくあるケースを快適にし、根底のモデルは変えません。エージェントに本当に独立したリポジトリが必要なら、別々のcloneが要ります。そのときworktreeを安くしている共有オブジェクトストアは失われます。
ツールが触れていない調整の問題もあります。10個のブランチの10個のエージェントは、同じ3つのファイルに触る10個のプルリクエストを生み、どれだけworktreeを管理してもそれがきれいにマージされるようにはなりません。並列化から価値を得ているチームは、エージェントを最も多く走らせているチームではなく、重ならない領域を割り当てているチームのようです。
この種のツールが注目を集める理由
エージェントフレームワークは発表を手に入れます。エージェントを使えるものにするユーティリティがスターを手に入れます。
このパターンは今年ずっと繰り返されてきました。メモリレイヤー、権限モード、サンドボックス、worktreeマネージャー。どれも、モデルが仕事をするのに十分良くなり、周囲の環境が、疲れず、質問せず、間違ったディレクトリで40分でも平気で走り続ける労働者向けに設計されたことが一度もなかったために存在します。
Worktrunkはそうした隙間のひとつに対する、小さく焦点の合った答えです。11,900というスターは、3つのエージェントを同時に走らせようとして、難しいのはファイルシステムのほうだと気づいた開発者の数です。