Git Worktrees

stash せずに複数のブランチで同時に作業できます。ブランチごとに専用のフォルダを持ち、ステータスバーから切り替えられます。

Worktrees は、日々の開発で最もストレスのたまる問題のひとつ、「作業の途中でブランチを切り替えなければならない」という状況を解決します。Worktrees を使えば、ブランチを切り替える必要はありません。別のブランチを2つ目のフォルダで開き、両方で同時に作業できます。

Git Worktree とは?

通常、Git リポジトリには作業ディレクトリが1つだけあります。ファイルが置かれているフォルダです。そのフォルダでチェックアウトされているブランチは、常にちょうど1つです。別のブランチを確認したい場合はそのブランチをチェックアウトする必要があり、ファイルがそのブランチのバージョンに置き換わります。現在の作業をコミットしていなければ、先に stash しなければならず、面倒でミスも起こりがちです。

Worktree は、同じ Git リポジトリにリンクされた2つ目(あるいは3つ目、4つ目)の作業ディレクトリです。各 worktree は、それぞれ独自のブランチ、ファイルの状態、履歴を持ちます。すべての worktree が同じ .git フォルダとコミット履歴を共有しており、同じリポジトリを別々のウィンドウから見ているようなものです。

具体例を挙げます。AI エージェントが feature/payments で新機能の実装を進めている最中に、同僚から fix/login-bug の PR レビューを頼まれたとします。機能開発の作業を stash する代わりに、fix/login-bug 用の worktree を別フォルダに作成します。PR のレビューはそちらで行い、機能ブランチは元のフォルダのまま手つかずで残ります。

Worktree を作成する

  1. Git パネルを開きます(Cmd+G を押します)
  2. パネル上部の Worktrees タブをクリックします
  3. + Add Worktree をクリックします
  4. ブランチを選択します。一覧から既存のブランチを選ぶか、新しいブランチ名を入力して作成します
  5. 新しい worktree のフォルダの場所を選択します(デフォルトでは、1DevTool が現在のプロジェクトフォルダの隣のフォルダを提案します)
  6. Create をクリックします。1DevTool が git worktree add を実行し、新しい worktree のフォルダをアクティブなワークスペースとして開きます

新しい worktree が、メインの worktree と並んで Worktrees タブに表示されます。

Git worktree

Worktree のターミナル

1DevTool は worktree を作成すると、その worktree のフォルダを対象とした新しいターミナルも開きます。ターミナルのタイトルにはブランチ名が表示されるので、今どのブランチで作業しているのか常に分かります。

そのターミナル内の AI エージェントは worktree のフォルダで動作します。他のブランチを意識することも、他のブランチに干渉することもなく、そのブランチ上でファイルの読み書き、コマンドの実行、変更を行えます。

Add terminal for git worktree

Git worktree terminal with branch name

複数の worktree でエージェントを同時に実行することもできます。あるエージェントが決済機能に取り組んでいる間に、別のエージェントが別のブランチでバグを修正する、といった使い方です。どちらのエージェントも専用のターミナル、専用のファイルコンテキスト、専用のブランチを持っているため、互いに衝突することはありません。

ステータスバーから Worktree を切り替える

プロジェクトにリンクされた worktree がある場合、ステータスバーのブランチチップの隣に、アクティブなチェックアウトの名前が表示されます。色や、primary・ロック・dirty のマークも一緒に表示され、Git Client を開かずに worktree を切り替えられます。

The status bar worktree picker with the No terminal in this worktree empty state and the file explorer scoped to that checkout

切り替え後に、期待どおりの場所に着地できるよう、次の2点が考慮されています。

  • その worktree に属するターミナルが前面に表示されます。 別のチェックアウトのタブに取り残されることはありません。コマンドが誤ったツリーで実行されてしまう原因として最も多いのが、このパターンです。
  • ターミナルのない worktree はそのことを明示します。 表示できるターミナルがないチェックアウトでは、別の場所から残ったペインの代わりに、No terminal in this worktree と Add terminal in this worktree ボタンが表示されます。

ファイルエクスプローラーもアクティブな worktree に追従するため、閲覧しているツリーとコマンドが実行されるツリーが一致します。

Worktree を削除する

worktree が不要になったとき(PR がマージされ、ブランチが削除された後など)は、きれいに削除できます。

  1. Git パネルを開き、Worktrees タブに移動します
  2. 削除したい worktree を探します
  3. その横にあるゴミ箱アイコンをクリックします
  4. 削除を確認します

これにより、worktree のフォルダが削除され、Git への登録も解除されます(git worktree remove に相当します)。ブランチ自体は削除されず、作業ディレクトリだけが削除されます。必要になれば、後から worktree を作り直せます。

Tip: worktree を使えば、main を安定した状態に保ったまま、フィーチャーブランチで AI エージェントを実行できます。エージェントが誤って main ブランチを壊すことはありません。

Worktrees は、Git の機能の中でも特に活用されていないもののひとつです。AI を活用した開発では、エージェントが数分のうちに何十ものファイルを変更することもあります。そのような状況で、各エージェントの作業を専用のブランチとフォルダに分離できることは、大きなセーフティネットになります。