メインコンテンツまでスキップ
バージョン: 0.8.x

Worktree

Worktree パネルでは、ターミナルを離れることなく Gitti から直接 Git の worktree を管理できます — 一覧表示、切り替え、追加、削除、プルーン、ロック/アンロック。worktree を使うと、単一のリポジトリから複数のブランチを別々のディレクトリにチェックアウトできます。

備考

Worktree 管理はメインリポジトリに対して動作します。ベアリポジトリはサポートされていません。

Worktree パネルへのアクセス​

Worktree パネルは、左上のコンポーネントパネルを ローカルブランチ、タグ、リモート と共有しています。

  1. 1 を押して ローカルブランチ / タグ / リモート / Worktree パネルにフォーカスします。
  2. > を押してパネルを右に切り替えます：ローカルブランチ → タグ → リモート → Worktree。
  3. < を押して戻ります。

キーバインディング​

キーアクション備考
< / >コンポーネントパネルの切り替えローカルブランチ、タグ、リモート、Worktree 間を切り替え
↑ / k前のエントリに移動
↓ / j次のエントリに移動
enterWorktree を切り替え選択した Worktree に切り替え
n新しい WorktreeWorktree 追加入力フローを開く
backspaceWorktree を削除削除確認ポップアップを開く
oWorktree をロック / アンロックロック状態を切り替え（メイン Worktree では利用不可）
ctrl+pWorktree をプルーン古い/欠落した Worktree の参照を削除
?キーバインディングと手順専用ヘルプポップアップを開く

各エントリの表示内容​

各 worktree エントリには以下のステータスマーカーが表示されることがあります：

  • Main — メインの worktree（削除やロックはできません）。
  • Current Worktree — 現在いる worktree。
  • Locked — プルーン/削除に対してロックされている worktree。
  • Locked Reason — ロック時に指定された理由（ある場合）。
  • Prunable — ディレクトリが欠落/古くなっており、プルーン可能な worktree。

ワークフロー​

新しい Worktree を追加​

  1. < / > を使用して Worktree パネルを選択します。
  2. n を押します。
  3. 新しい Worktree の追加入力ポップアップが表示されます：
    • Worktree 名 — 新しい worktree のディレクトリ名（必須）。
    • ブランチ名 — 任意。 チェックアウトするローカルまたはリモートのブランチ。origin/<branch> を使用すると detached HEAD になります。
  4. enter を押して worktree を作成します。

Worktree に切り替え​

  1. ↑/↓ を使用して対象の worktree を選択します。
  2. enter を押します。
注記

すでにいる worktree や、プルーン可能（古い/欠落した）worktree には切り替えできません。

Worktree をロック / アンロック​

ロックすると、worktree がプルーンや削除されるのを防ぎます。

  1. ↑/↓ を使用して対象の worktree を選択します。
  2. o を押します。
    • アンロック状態の場合、任意のロック理由を入力するポップアップが表示され、ロックします。
    • ロック状態の場合、すぐにアンロックされます。
注記

メイン worktree はロックもアンロックもできません。

Worktree を削除​

  1. ↑/↓ を使用して対象の worktree を選択します。
  2. backspace を押します。
  3. worktree のパスを示す確認ポップアップが表示されます。
  4. 確認して worktree を削除します。

Worktree をプルーン​

ディレクトリが存在しなくなった worktree（Prunable と表示）の管理参照をクリーンアップします。

  1. Worktree パネルを選択します。
  2. ctrl+p を押します。