vibe start

startコマンドは指定したブランチ用のGit Worktreeを作成し、そのディレクトリに移動します。

使い方

vibe start <branch> [options]

オプション

オプション	説明
--reuse	既存ブランチを使用（新規作成しない）
--base <ref>	新規ブランチのベース（ブランチ/コミット）
--track	—base使用時にupstreamを設定
--no-hooks	pre-startとpost-startフックをスキップ	v0.5.0+
--no-copy	ファイル・ディレクトリのコピーをスキップ	v0.5.0+
-n, --dry-run	実行せずに操作内容をプレビュー	v0.8.0+
-V, --verbose	詳細な出力を表示	v0.8.0+
-q, --quiet	不要な出力を抑制	v0.8.0+
--claude-code-worktree-hook	Claude Code WorktreeCreateフックモード	v0.23.0+

※--baseは新規ブランチ作成時のみ有効です。既存ブランチの場合は無視されます。デフォルトでは--baseはupstreamを設定しません。upstreamを設定するには--trackを使用してください。

※--claude-code-worktree-hookはClaude CodeのWorktreeCreateフックから内部的に使用されます。設定の詳細はClaude Code連携を参照してください。

例

# 新しいブランチでWorktreeを作成
vibe start feat/new-feature

# 既存ブランチを使用
vibe start feat/existing-branch

# ベースブランチから新規作成
vibe start feat/from-main --base main

# フックなしでクイックスタート
vibe start feat/quick-fix --no-hooks

# ファイルコピーなしで開始
vibe start feat/clean-slate --no-copy

# 実行内容をプレビュー（短縮オプション）
vibe start feat/preview -n

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

# 出力を抑制
vibe start feat/silent -q

動作

冪等な操作

vibe startは冪等です - 同じブランチで複数回実行しても安全：

• 同じブランチのWorktreeが既に存在する場合、vibeはそこに移動します
• 重複したWorktreeは作成されません

インタラクティブプロンプト

vibe startは様々な状況に対話的に対応します：

ブランチが他のWorktreeで使用中の場合

$ vibe start feat/new-feature
ブランチ 'feat/new-feature' は既にWorktree '/path/to/repo-feat-new-feature' で使用中です。
既存のWorktreeに移動しますか? (Y/n)

異なるブランチのディレクトリが存在する場合

以下から選択できます：

• 上書き: 削除して再作成
• 再利用: 既存ディレクトリをそのまま使用
• キャンセル: 操作を中止

Worktreeの配置場所

デフォルトでは、Worktreeはメインリポジトリの兄弟として作成されます：

/path/to/repo/                   # メインリポジトリ
/path/to/repo-feat-new-feature/  # Worktree

ワークフロー

vibe start実行時：

1. pre_startフックが元リポジトリで実行（設定されている場合）
2. Worktree作成: Git Worktreeが作成される
3. ファイルコピー: ファイル/ディレクトリがコピーされる（設定されている場合）
4. post_startフックが新しいWorktreeで実行（設定されている場合）
5. ディレクトリ変更: ターミナルが新しいWorktreeに移動

関連

• clean - 作業完了後のWorktree削除
• フック - 自動ワークフローの設定