vibe jump

jumpコマンドはブランチ名をマッチングして既存のGit Worktreeに移動します。完全一致、部分一致、ファジーマッチ、インタラクティブな選択をサポートしています。

使い方

vibe jump <branch-name> [options]

オプション

オプション	説明
`-V`, `--verbose`	詳細な出力を表示
`-q`, `--quiet`	不要な出力を抑制

例

# 完全なブランチ名でWorktreeにジャンプ
vibe jump feat/new-feature

# 部分一致でジャンプ
vibe jump login

# ファジーマッチでジャンプ（部分列マッチング）
vibe jump feli   # "feat/login" にマッチ

# 詳細な出力を表示
vibe jump feat/debug -V

動作

検索順序

vibe jumpは以下の順序でWorktreeを検索します：

完全一致（大文字小文字区別あり）: 完全に一致するブランチ名のWorktreeが存在する場合、即座に移動
完全一致（大文字小文字区別なし）: 大文字小文字を無視して一致するWorktreeが存在する場合、そこに移動
単語境界一致（大文字小文字区別あり→なし）: 入力が単語境界（/、-、_ の直後）に出現する場合、通常の部分文字列一致より優先される
部分文字列一致（大文字小文字区別あり→なし）: 単語境界一致がない場合、部分文字列一致にフォールバック。複数のWorktreeが一致する場合、インタラクティブな選択プロンプトを表示
ファジーマッチ（部分列マッチング）: 部分文字列一致がなく、検索語が3文字以上の場合、検索語の各文字がブランチ名内に順序通りに出現するかを判定（例: feli → feat/login）。連続一致、単語境界、マッチ位置を考慮したスコアリングアルゴリズムで結果をランク付け
一致なし: vibe startで新しいWorktreeを作成するか確認

完全一致

$ vibe jump feat/new-feature
# → cd '/path/to/repo-feat-new-feature'

部分一致

$ vibe jump login
Matched: feat/login-page
# → cd '/path/to/repo-feat-login-page'

ファジーマッチ

$ vibe jump feli
Matched: feat/login
# → cd '/path/to/repo-feat-login'

Scratch worktree の除外

scratch/ プレフィクスを持つブランチ（vibe scratch で作成）は、デフォルトで 単語境界・部分文字列・ファジーマッチの候補から除外 されます。scratch が溜まっても候補リストが汚染されないようにするためです。

scratch にジャンプするには次のいずれかを使います:

文字どおり scratch/ プレフィクスをクエリの先頭に含める（大文字小文字区別なし）。この場合、scratch/ 配下のブランチも部分一致／ファジーマッチの対象になります:
```
$ vibe jump scratch/2026
# → cd '/path/to/scratch-20260427-143052'
```
ブランチ名を完全に指定する。完全一致は scratch でも常に通ります。

複数一致

$ vibe jump auth
Multiple worktrees match 'auth':
  1. feat/auth-login (/path/to/repo-feat-auth-login)
  2. feat/auth-logout (/path/to/repo-feat-auth-logout)
  3. Cancel
Please select (enter number):

一致なし（フォールバック）

$ vibe jump feat/nonexistent
No worktree found for 'feat/nonexistent'. Create one with 'vibe start'? (Y/n)

確認すると、vibe startが呼び出されてWorktreeが作成されます。

終了コード

コード	条件
`0`	正常な移動、またはユーザーによるキャンセル
`1`	エラー（空のブランチ名、gitコマンドの失敗など）

ユーザーが自発的にキャンセルした場合（選択プロンプトで「Cancel」を選択、または新しいWorktreeの作成を拒否）は、エラーではなく正常終了として扱われます。

制限事項

detached HEAD のWorktree: detached HEAD状態（ブランチに紐づいていない）のWorktreeは検索対象に含まれません。ブランチ参照を持つWorktreeのみが検索可能です。