Worktrunk - ブランチ名でGit worktreeを管理するCLI
Worktrunkは、Git worktreeをブランチ名で操作するRust製CLIだ。通常のコマンド名はwt。複数の開発タスクやAIエージェントに作業ディレクトリを割り当てる際の、作成、移動、環境準備、状態確認、統合、削除をまとめて扱う。中心にあるのは、ブランチ名から設定テンプレートで配置パスを求める設計である。 その上にシェル連携、準備処理を実行するフック、コピーオンライトによるキャッシュ共有を重ねる。ただし、作業ディレクトリの分離を、エージェントの安全な実行環境と同一視することはできない。キャッシュの整合性管理やフック失敗時の復旧なども、提示されたREADMEとリリースノートだけでは判断できない。
ポッドキャスト形式で聴く
約4分AI生成の会話音声です。記事の要点を短くまとめています。
なぜ注目されているか
2026年11月6日の取得時点でGitHub Trending日次7位、当日546スター増を記録した。リポジトリは11,537スター、439フォーク。11月9日まで勢いが続いているかは未確認で、これらの数値は技術性能や生産性の証明ではない。
なぜ重要なのか
並列開発で増えるのは、実行するエージェントの数だけではない。各タスクに作業場所を用意し、依存関係を準備し、変更の状態を追い、終了後に片付ける管理も増える。Worktrunkの設計は、この反復をworktreeのライフサイクルとしてCLIに集約するものと捉えられる。
作成時の準備と統合後の処理をプロジェクトの定型手順にできれば、並列作業を始める負担を減らせる可能性がある。一方で、自動化したコマンドの信頼性や失敗時の扱いまで検討する必要がある。注目すべき点は、並列実行による生産性の主張よりも、作業ディレクトリを運用する責任をどこまでツールへ移せるかにある。
この記事に出てくる言葉(5語)
- worktree
Gitで別のブランチの作業に使う作業ディレクトリ。Worktrunkではブランチ名やworktreeパスで操作対象を指定する。
- パステンプレート
ブランチ名からworktreeの配置先を計算する設定。操作時のブランチ指定と、実際のディレクトリ配置を結び付ける。
- post-startフック
依存関係のインストールや開発サーバー起動を自動化するためのフック。-xによるプログラム起動との厳密な順序は提示資料では未確認。
- picker
worktreeを対話的に選ぶためのUI。CI状態やdiff、log、PR、コメントのプレビューも扱う。
- コピーオンライトのキャッシュ共有
READMEがtarget/やnode_modules/など向けに紹介する共有方式。APFS、btrfs、XFSが挙げられるが、具体的な実装や整合性管理の詳細は未確認。
1. 読む前に知っておきたいこと
ブランチと作業パスを二重に管理する負担
Git標準の操作では、git worktree addにブランチと配置先を指定し、cdで移動してからエージェントやエディタを起動する。終了後には元の作業場所へ戻り、worktreeとブランチをそれぞれ削除する。WorktrunkのREADMEは、この一連の操作と自らのコマンドを比較している。
ここでは、作業対象を表すブランチ名に加えて、その作業場所を表すパスも扱う必要がある。タスクが増えるほど、どのブランチをどこへ配置したかを作成時と移動時の両方で意識することになる。Worktrunkはブランチ名を操作の入口にし、配置先の計算を設定へ移すことで、この重複を減らそうとする。
Git worktreeを利用する点は共通している。違いは、その周辺にある移動、準備、状態確認、後片付けを、どの単位でまとめて操作するかにある。
作業場所ができても開発は始まらない
並列作業では、worktreeを作成した後にも準備が残る。依存関係のインストールや開発サーバーの起動、ビルドに使うキャッシュの用意が必要なら、作業ディレクトリごとに扱うことになる。Worktrunkがフックとキャッシュ共有を備える理由は、この開始時の負担として理解できる。
また、作業中には各worktreeの変更、mainとの差分、未プッシュのコミットを確認し、終了時には変更の統合と削除を進める。作成コマンドだけを短くしても、これらの手順は残る。Worktrunkの対象は、worktreeの生成から終了まで続く管理である。
この前提から、評価すべき便益も絞れる。単一の作業ディレクトリで開発が完結する場合より、同じリポジトリでタスクを分け、作成と切り替えを繰り返す場合に、操作を集約する意味が大きいと考えられる。
注目の観測値と技術的な根拠を分ける
2026年11月6日のGitHub Trending取得値では、Worktrunkは日次7位、当日546スター増、累計11,537スター、439フォークだった。これはその時点での注目を示す数値であり、11月9日まで上昇が続いたことや、並列開発の生産性を証明するものではない。
技術説明の根拠は、提示されたREADMEとリリースノートである。取得されたリリース一覧の先頭はv0.81.0だった。以下では、そこで確認できるコマンド、フック、実行場所、統合手順をつないで仕組みを読む。内部モジュール構成や未取得の公式ドキュメント本文まで検証された設計としては扱わない。
2. どう動くのか
ブランチ名を受け取り、配置先へ解決する
Worktrunkの中心となる対応関係は、ブランチ名とworktreeの配置パスである。通常は設定可能なテンプレートからパスを計算するため、利用者はブランチ名で対象を指定できる。ブランチを受け取るコマンドはworktreeパスも受け取るので、パスによる指定も残されている。
作成と起動の例は、wt switch -c -x claude feature-a -- 'Add user authentication'である。-cでブランチとworktreeを作成し、-xで切り替え後に実行するプログラムを指定する。--以降の引数はそのプログラムへ渡される。READMEの作成例ではmainを起点にブランチを作る。
ここで設定テンプレートが担うのは、作業対象の名前から実際の配置先を求めることだ。名前を指定する操作と配置規則を分けられる。一方、v0.81.0には、ブランチ名を保ったままテンプレート外へ配置するwt switch --pathもある。これは実験的機能とされており、通常の配置規則を外れる使い方の安定性は別途見極める必要がある。
シェルの移動とプログラムの実行場所を分ける
作成先へ呼び出し元シェルを移動させるには、シェル連携が必要になる。READMEではwt config shell installで導入する。Worktrunkの「切り替え」には、操作対象を選ぶことに加え、利用者が次にコマンドを入力する場所を変える役割がある。
一方、起動プログラムの作業場所は、呼び出し元シェルを移動するかどうかと区別されている。v0.79.0以降、wt switch --no-cd -xでもプログラムは対象worktreeで動く。--no-cdが制御するのは呼び出し元シェルの移動だけである。
したがって実行の流れは、対象のブランチとworktreeを決め、必要なら作成し、そのworktreeで指定プログラムを動かす、と整理できる。シェル側の現在位置を維持する場合でも、エージェントを動かす場所は対象worktreeになる。この区別は、切り替えコマンドを既存の作業手順へ組み込む際に重要だ。
準備をフックへ寄せ、キャッシュを共有する
フックは作成時やマージ前後などのタイミングでコマンドを実行する。post-startフックには、依存関係のインストールや開発サーバー起動を設定できる。worktreeの作成に準備処理を結び付ければ、作業開始時に繰り返す操作を定型化できる。
ただし、post-startと-xによる起動の厳密な実行順序は、提示された本文では確認できない。「依存関係の準備が完了してから必ずエージェントが起動する」とは断定できず、両者に順序依存がある構成では確認が必要になる。
キャッシュについて、READMEはtarget/やnode_modules/などを対象に、コピーオンライトによる共有を紹介している。挙げられているファイルシステムはAPFS、btrfs、XFSだ。多数のworktreeにキャッシュを用意する負担を減らす用途に合うと考えられるが、これはREADMEに基づく機能説明である。
具体的なシステムコール、対応OSとの組み合わせ、非対応環境での代替動作、共有後の更新と整合性管理は提示資料にない。そのため、一般的な環境で同じ効果が得られることや、キャッシュが常に期待どおり再利用されることまで前提にはできない。
一覧表示はローカル状態とCI情報を扱う
作業中はwt listで、worktreeの変更、mainとの差分、未プッシュ状態などを確認できる。対話的pickerはCI状態に加え、diff、log、PR、コメントのプレビューも扱う。作業ディレクトリの管理に、変更の内容と外部のレビュー・CI情報を組み合わせる構成だ。
この部分の負担を示す材料として、開発者はv0.80.0で、50 worktreeのリポジトリにおけるpickerの行ごとの処理開始が120msから47msになったと報告している。これは一覧全体の完了時間ではなく、測定機材や反復条件も記載されていない。独立した性能検証としては扱えない。
また開発者は、未プッシュブランチへのCI問い合わせを省き、239本のローカルブランチがあるリポジトリでgh呼び出しを249回から25回へ減らしたと報告する。対象はwt list --full、picker、statuslineだ。こちらは問い合わせ回数であり、実行時間の短縮率ではない。ローカルの作業状態を表示する機能でも、CI情報を含めれば外部への問い合わせが関与することが分かる。
統合と削除までを一つの流れにする
ローカルで変更を統合するwt merge mainは、squash、mainへのrebase、fast-forward merge、後片付けをまとめる。READMEの成功例では、worktreeとブランチをバックグラウンドで削除し、mainのworktreeへ戻る。作業終了後に必要な複数の操作をつなぐ設計である。
PRを通す運用も案内されている。GitHubやGitLabでPR/MRを作成・マージし、wt removeで後片付けする流れだ。したがって、Worktrunkを使うためにローカル統合へ統一する必要はなく、既存のレビュー手順を伴う運用にも組み込める。
作成時のパス解決から、プログラム起動、状態確認、統合、削除までを合わせると、操作対象は一貫してタスクのworktreeである。ただし、成功例に示された流れと、失敗時や削除時の保護条件は別の話だ。後者の詳細は提示資料から判断できない。
3. 使いどころと限界
Git標準操作を集約する価値があるチーム
適合しやすいのは、同じリポジトリで複数のタスクやAIエージェントを並行して動かし、それぞれの作業ディレクトリを分ける開発だ。作成時の依存関係準備やサーバー起動を定型化したい場合には、フックも評価対象になる。対応ファイルシステム上で多数のworktreeにキャッシュを用意するなら、共有機能の想定用途にも合う。
比較対象となるGit標準CLIでは、git worktree add、cd、git worktree remove、git branch -dなどを組み合わせる。Worktrunkは同じGit worktreeを使い、その操作方法として競合する。追加されるのは、ブランチ名による対象指定、配置規則、準備の自動化、統合後の処理をまとめる層だ。
一方、worktreeの作成や切り替えをほとんど行わないなら、集約による便益は小さいと考えられる。導入の判断には、普段どの操作を何度繰り返しているかを見るのが適切だ。
フックは互換性と対話方法まで確認する
v0.81.0では、フックへJSONコンテキストを標準入力で渡す仕様が廃止された。値はテンプレート引数やtojsonで渡す。既存フックが標準入力のJSONに依存している場合には修正が必要であり、変更できない環境では導入上の障害になる。
実行方式による標準入力の違いもある。直列のフォアグラウンドフックは標準入力を継承するが、並行・バックグラウンドフックはEOFを読む。同じコマンドをフックへ移す場合でも、入力を待つ処理がどの方式で実行されるかを確認する必要がある。
さらに、フック設定の承認方法や信頼境界、途中で失敗した場合の復旧は、提示されたREADMEだけでは判断できない。準備処理を自動化する便益とともに、実行されるコマンドを誰が管理し、失敗後にどう作業を再開するかが運用上の検討事項になる。
作業ディレクトリの分離と権限の隔離
Worktrunkで説明されている分離単位は、Git worktreeの作業ディレクトリである。別々のタスクへ作業場所を与えられることから、プロセス、認証情報、ネットワーク、外部サービスまで隔離されるとは言えない。提示資料にサンドボックス機構の説明はない。
そのため、信頼できないコードやエージェントを隔離して実行する環境が必要な場合、Worktrunkの機能だけを根拠に要件を満たしたと判断できない。フックがコマンドを実行することも含め、作業場所の管理と実行権限の管理を分けて評価する必要がある。
同様に、統合と後片付けを一括実行できることは、マージや削除のあらゆる保護条件を確認できたことを意味しない。詳細な保護条件が不明なまま、成功例をすべての作業状態へ一般化するべきではない。
プラットフォーム差と運用負担を見込む
WindowsではwtがWindows Terminalのコマンドと衝突する。Winget版が導入するgit-wtを使うか、Windows Terminalの実行エイリアスを無効化してwtを使う方法が案内されている。チームで同じ操作を共有する場合には、この名前の違いも考慮する必要がある。
運用負担の評価では、フックで起動する準備処理、キャッシュ共有の条件、CI情報を取得する問い合わせを切り分けたい。提示された性能報告から、これらを含む総実行時間や資源消費、並列開発全体の生産性までは導けない。
導入時には、自分たちの配置規則、既存フック、ファイルシステム、レビュー手順に合うかを確かめることになる。機能をまとめて使える点に価値はあるが、その便益は作業の反復量と環境条件に依存する。
このツールから考える
ここからは、一次情報と限界を踏まえた編集上の考察です。
Worktrunkでは、ブランチ名を配置パスへ解決し、作成や統合にフックを結び付ける。この仕組みから見えるのは、作業ディレクトリを作る操作だけでなく、その準備から終了までをプロジェクトの手順として管理する方向だ。複数のエージェントへタスクを配るなら、作業場所の用意と回収を定型化できる意味は大きいと考えられる。
ただし、手順をCLIへ集約しても、実行するコマンドの信頼性や失敗後の復旧という責任は残る。フックの承認・信頼境界や削除の保護条件が提示資料では分からない点は、この方向を評価するうえで重要だ。今後見るべきなのは、作業開始の短さに加え、自動化が途中で止まったときにも、利用者が状態を把握して次の操作を判断できるかである。
検証に使用した一次情報
DevTool Lensでは、第三者の二次情報やREADMEの宣伝文句に依存せず、以下の公式リポジトリ・ドキュメント・リリース情報を精査して記事を作成しています。
- [readme]max-sixty/worktrunk README
- [repo]max-sixty/worktrunk GitHub Repository
- [release]max-sixty/worktrunk Releases
- [github_trending]GitHub Trending Daily (2026-11-06)