CC逆引きリファレンス

git worktree の作成・削除をフックしたい

11. フック

コマンド / 機能

WorktreeCreate / WorktreeRemove

エージェント worktree のライフサイクル

概要

WorktreeCreate はエージェントの git worktree が作成される時、WorktreeRemove は削除される時に発火します。デフォルトの git worktree 操作を置き換えるカスタム処理を実装できます。

設定例

// .claude/settings.json
{
  "hooks": {
    "WorktreeCreate": [
      {
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/setup-worktree.sh"
          }
        ]
      }
    ],
    "WorktreeRemove": [
      {
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/cleanup-worktree.sh"
          }
        ]
      }
    ]
  }
}
公式ドキュメントを見る

こんな時に使う

  • worktree 作成時に追加のセットアップをしたい時
  • worktree 削除前にデータを保存したい時
  • カスタムの worktree 管理ロジックを実装したい時

使い方

  1. 1hooks.WorktreeCreate / hooks.WorktreeRemove にフックを定義
  2. 2エージェントが isolation: worktree で起動する時に発火

Tips

  • フックがデフォルトの git worktree 操作を置き換える
  • サブエージェントに isolation: worktree を設定すると有効になる