フック

フックを使用すると、Worktreeのライフサイクル中にコマンドを自動的に実行できます。

利用可能なフック

フック	実行タイミング	作業ディレクトリ
`pre_start`	Worktree作成後	元リポジトリ
`post_start`	Worktree作成後	新しいWorktree
`pre_clean`	Worktree削除前	現在のWorktree
`post_clean`	Worktree削除後	メインリポジトリ

設定

[hooks]
pre_start = ["echo 'Worktreeを準備中...'"]
post_start = [
  "pnpm install",
  "pnpm db:migrate"
]
pre_clean = ["git stash"]
post_clean = ["echo 'クリーンアップ完了'"]

環境変数

すべてのフックコマンドで以下の環境変数が利用可能です：

変数	説明
`VIBE_WORKTREE_PATH`	作成されたWorktreeの絶対パス
`VIBE_ORIGIN_PATH`	元リポジトリの絶対パス

使用例

[hooks]
post_start = [
  "echo 'Worktree作成先: $VIBE_WORKTREE_PATH'",
  "echo '元リポジトリ: $VIBE_ORIGIN_PATH'"
]

フック実行時の出力動作

vibeはフック実行中にリアルタイム進捗ツリーを表示します：

✶ Setting up worktree feature/new-ui…
┗ ☒ Pre-start hooks
   ┗ ☒ npm install
     ☒ cargo build --release
  ⠋ Copying files
   ┗ ⠋ .env.local
     ☐ node_modules/

出力の処理

状況	標準出力	標準エラー出力
進捗表示が有効	抑制される	常に表示
進捗表示が無効	標準エラーに出力	常に表示
失敗したフック	N/A	常に表示

フック実行順序

vibe startの場合：

Worktreeが作成される
[submodules] configs = [...]の場合、指定されたサブモジュールが初期化される
各サブモジュールの信頼済みpre_start、copyルール、post_startがサブモジュールルート基準で実行される
親のpre_startフックが元リポジトリで実行
親のファイル/ディレクトリがコピーされる
親のpost_startフックが新しいWorktreeで実行

vibe cleanの場合：

pre_cleanフックが現在のWorktreeで実行
Worktreeが削除される
post_cleanフックがメインリポジトリで実行

よくあるパターン

Node.jsプロジェクト

[hooks]
post_start = [
  "pnpm install",
  "pnpm build"
]
pre_clean = ["git stash --include-untracked"]

Bunプロジェクト

[hooks]
post_start = [
  "bun install",
  "bun run build"
]
pre_clean = ["git stash --include-untracked"]

データベースマイグレーション

[hooks]
post_start = [
  "pnpm install",
  "pnpm db:migrate",
  "pnpm db:seed"
]

Docker環境

[hooks]
post_start = [
  "docker-compose up -d",
  "sleep 5",
  "pnpm db:migrate"
]
pre_clean = ["docker-compose down"]

Gitサブモジュール

直接サブモジュールに独自のsetupファイルやフックがある場合は、ファーストクラスのサブモジュール設定を使用してください：

[submodules]
configs = ["libs/foo"]

これは新しいWorktree内でgit submodule update --init -- libs/fooを実行し、その後libs/foo/.vibe.tomlを通常のtrust store経由で読み込みます。サブモジュールのcopyルールとフックはlibs/foo基準で解決され、親リポジトリのpre_startフックより前に実行されます。

フックのスキップ

--no-hooksオプションでフックをスキップできます：

vibe start feat/quick-fix --no-hooks

Claude Code連携

vibeはClaude CodeのWorktreeCreateおよびWorktreeRemoveフックと連携できます。これにより、Claude Codeのデフォルトのgit worktree add動作をvibeのフルワークフロー（フック、CoWファイルコピー、設定を含む）に置き換えます。

セットアップ

Claude Codeのsettings.jsonに以下を追加してください：

{
  "hooks": {
    "WorktreeCreate": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "vibe start --claude-code-worktree-hook --quiet 2>/dev/null"
          }
        ]
      }
    ],
    "WorktreeRemove": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "vibe clean --claude-code-worktree-hook --force 2>/dev/null"
          }
        ]
      }
    ]
  }
}

動作の仕組み

Claude CodeがWorktreeを作成する場合（自然言語、isolation: "worktree"、または/worktreeコマンド経由）、vibeがフルライフサイクルを管理します：

WorktreeCreate:

stdinからWorktree名を読み取り（Claude Codeフックプロトコル）
git Worktreeを作成
[submodules] configs = [...]の場合、指定されたサブモジュールを初期化し、信頼済みsetupを実行
元リポジトリで親のpre_startフックを実行
CoWを使用して親のファイル/ディレクトリをコピー
新しいWorktreeで親のpost_startフックを実行（例：pnpm install）
Claude Code向けにWorktreeパスをstdoutに出力

WorktreeRemove:

stdinからWorktreeパスを読み取り（Claude Codeフックプロトコル）
Worktreeでpre_cleanフックを実行
git Worktreeを削除
メインリポジトリでpost_cleanフックを実行

メリット

この連携がない場合、Claude CodeのWorktree作成はgit worktree addのみを実行します。vibeのフックを使用することで、以下が自動的に行われます：

依存関係の自動インストール（pnpm install、bun installなど）
CoWファイルコピー（.env、node_modulesなど）
カスタムセットアップスクリプト（データベースマイグレーション、Dockerコンテナなど）
Worktree削除時のクリーンアップフック