3つのエージェント、1つのリポジトリ、そして衝突への道
単一のGitチェックアウトで複数のAIエージェントを実行することは、衝突を待っているようなものです。リファクタリングの途中のエージェントAが、共有依存関係や競合するファイル編集によって、突然エージェントBのテストを壊してしまうことがあります。この共有フォルダの問題は、並行開発を阻害します。
Git worktreesは即効性のある解決策を提供します。各タスクに独立したディレクトリ、独自のブランチ、クリーンなワークスペースが割り当てられます。この2つ目のチェックアウトはリポジトリの履歴を共有しますが、エージェントはもう同じ紙に書き込んでいるわけではありません。これは作業を並列化するための強力なプリミティブです。
しかし、標準のGit worktreesには独自の摩擦があります。作成するにはブランチ名を3回入力し、手動でディレクトリを変更する必要があります。クリーンアップには、worktreeとそのブランチを削除するためにさらに3つのコマンドが必要です。
さらに、Gitにステータスを尋ねても、フォルダパスの静的なリストしか返されません。各エージェントが何をしているのかを示す単一の動的なビューはなく、統合されたマージコマンドもなく、依存関係は手動で管理する必要があります。Claude Codeのようなネイティブのworktreeサポートは作成を修正しますが、これらの重要なギャップは残されたままです。
フォルダ管理を置き換えるワンラインのワークフロー
Worktrunkは、フォルダパスからブランチへ焦点を移すことで、並行エージェントのワークフローを合理化します。wt switch <branch>はworktreeを作成または切り替えるため、ブランチ名の入力やディレクトリパスを覚える必要がありません。この単一のコマンドで、各エージェント用に独立した環境がセットアップされます。
wt listは、統合されたインタラクティブなダッシュボードを提供します。アクティブなすべてのworktreeを表示し、そのブランチ、mainに対する進捗状況、diffサイズ、エージェントのアクティビティインジケーター（例：アクティブなエージェントにはロボットアイコン、入力を待機中のエージェントには吹き出し）を表示します。これにより、標準のgit worktree listの静的なフォルダパスが、アクション可能なコンテキストに置き換わります。
エージェントがタスクを完了すると、wt mergeが複雑な6ステップのGitライフサイクルを1つのコマンドに自動化します。コミット、スカッシュ、mainへのリベース、ファストフォワードを行い、完了したworktreeとそのブランチを削除します。wt mergeは重い作業のほとんどを自動化しますが、競合が発生した場合はリベースが停止し、人間の介入が必要になります。
スピードの秘訣：各エージェントが必要とするものを再利用する
複数のエージェントを実行するには効率的なセットアップが必要です。Worktrunkはライフサイクルフックを提供し、worktree作成時にセットアップタスクを自動的に実行します。これにより、繰り返される依存関係のインストールや手動の環境設定が不要になり、各エージェントがすぐに生産的な作業を開始できます。
Worktrunkはwt step copy-ignoredを使用してストレージと速度の問題にも対処します。このコマンドはnode_modulesやビルドキャッシュなどの無視されたファイルを再利用します。サポートされているファイルシステム（APFS、Btrfs）では、変更が発生するまで元のファイルにリンクするcopy-on-writeを採用しています。これにより、ディスク容量と時間を大幅に節約できます。
動画では劇的な結果が示されています。14GBのRustビルドフォルダがcopy-ignoredで約20秒でコピーされ、通常は2分かかります。最初のRustビルドは68秒から3〜4秒に短縮されました。これらは作成者が報告したタイミングであり、普遍的なベンチマークではありません。ファイルシステムのサポートが重要であり、Linux上のEXT4では完全なコピーが実行されます。また、ネイティブモジュールは再ビルドが必要です。Worktrunkの並行エージェントワークフローへのアプローチの詳細については、Worktrunk — Git worktree management for parallel AI agent workflowsをご覧ください。
この記事が気に入ったら、毎朝同じようなものをメールで受け取れます。
1日1通 · 2クリックで解除 · サードパーティのトラッキングなし
便利で、動きが速く、すべての開発者向けではない
Worktrunkのターミナルファーストなオーケストレーションは、ネイティブのClaude Codeワークツリーとは対照的です。Claude Codeは基本的な分離と自動クリーンアップを処理しますが、ステータス監視やマージワークフローはユーザーに委ねられています。Worktrunkはこのギャップを埋め、すべてのエージェントアクティビティの単一ビューを提供し、コミット、スカッシュ、リベース、ワークツリー削除を処理するワンコマンドマージを実現します。
この小さなCLIは1.0未満（現在はv0.81）であり、破壊的変更が頻繁に発生するため、設定の更新を想定しておく必要があります。ディレクトリ切り替えのためのシェル関数設定は非常に重要であり、シェルコマンドを実行するプロジェクトフックの確認も同様です。未解決のマージコンフリクトは依然として手動での介入が必要で、Worktrunkはリベースを停止し、制御をユーザーに委ねます。
wt step copy-ignoredによるコピーオンライトの利点は、ファイルシステムに依存します。APFSではほぼ瞬時に完了し、大幅な容量節約になりますが、EXT4 Linux環境では完全なコピーが行われます。ネイティブモジュールは、新しいワークツリーで再ビルドが必要です。
一度に1つのエージェントを実行する場合、ネイティブのワークツリーや通常のGitで十分な可能性が高いです。しかし、3つ、5つ、あるいはそれ以上のエージェントを定期的に実行し、セットアップや依存関係のインストールからステータスチェック、マージ後のクリーンアップに至るまでのワークツリーのオーバーヘッドを削減する必要がある場合、Worktrunkは欠けているオーケストレーション層を提供します。
よくある質問
Worktrunkとは何ですか？
Worktrunkは、並行コーディングタスクやAIエージェントを実行する開発者のために、Gitワークツリー管理を簡素化するオープンソースのCLIです。
Worktrunkは並行AIエージェントの運用にどのように役立ちますか？
各タスクに独自のブランチとチェックアウトを割り当て、ワークツリーのステータスを1つのビューで表示し、マージとクリーンアップを効率化します。
WorktrunkはClaude Codeでのみ動作しますか？
いいえ。Claude Codeと統合されており、Codex、OpenCode、Gemini CLIなど、他のエージェントCLIもサポートしています。
Worktrunkはマージコンフリクトを解消しますか？
いいえ。ワークツリーは開発中にファイルを分離しますが、重複する変更はマージ時にコンフリクトする可能性があります。
Worktrunkは本番環境で使用できますか？
現在は1.0未満であるため、破壊的変更が発生する可能性があることを想定し、プロジェクトフックのシェルコマンドを承認する前に確認してください。