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 管理ロジックを実装したい時
使い方
- 1hooks.WorktreeCreate / hooks.WorktreeRemove にフックを定義
- 2エージェントが isolation: worktree で起動する時に発火
Tips
- フックがデフォルトの git worktree 操作を置き換える
- サブエージェントに isolation: worktree を設定すると有効になる