settings.json

WorktreeCreate

サブエージェント等でワークツリーが作成される際に実行されるフック。

使い方・用途

  • Git 以外の VCS（SVN等）を使用している環境や、独自の管理フローを持つプロジェクトにおいて、並行作業用のワークツリー作成処理をカスタムスクリプトで代替・自動化します。
英語原文(公式ドキュメントより)

Hooks that run when a worktree is created via --worktree or isolation: "worktree" in subagents. Command handlers only, no matchers. Hook must print absolute path to created worktree on stdout; non-zero exit fails creation. See https://code.claude.com/docs/en/hooks#worktreecreate

公式ドキュメントを参照

関連する変更履歴

v2.1.85 (1件)

Fixed
Hooks
非Gitリポジトリで--worktreeを使用した場合、WorktreeCreateフックが実行される前にエラーで終了してしまう問題を修正
英語原文を表示
Fixed --worktree exiting with an error in non-git repositories before the WorktreeCreate hook could run

変更前

Git以外のVCS（SVN等）をフックでサポートしようとしても、起動時のGitチェックで処理が止まってしまい、フックによるカスタム処理が実行できませんでした。

変更後

--worktree起動時のチェック順序が見直され、Gitがない環境でもフックによる独自のワークツリー作成処理を正しく開始できるようになりました。

ユーザーへの恩恵

Git以外のプロジェクト管理ツールを使用している開発者も、Claude Codeの強力な並行作業機能を活用できるようになります。

関連ドキュメント

v2.1.84 (1件)

Added
Hooks
HTTPタイプの WorktreeCreate フックで作成されたパスの返却に対応
英語原文を表示
Added WorktreeCreate hook support for type: "http" — return the created worktree path via hookSpecificOutput.worktreePath in the response JSON

変更前

WorktreeCreate フックをHTTP経由で実行した際、フックによって作成されたgitワークツリーのパスをClaude Code側に正確に伝える標準的な方法がありませんでした。

変更後

HTTPフックのレスポンスJSON内の hookSpecificOutput.worktreePath フィールドを通じて、作成されたパスを返せるようになりました。

ユーザーへの恩恵

独自のサーバーで管理している複雑なワークツリー作成フローをClaude Codeとシームレスに統合でき、並行作業の自動化がより強固になります。

関連ドキュメント

v2.1.69 (1件)

v2.1.64 (2件)

Fixed
Hooks Plugins
プラグインによって登録された WorktreeCreate および WorktreeRemove フックが、誤って無視されてしまう問題を修正しました。
英語原文を表示
Fixed WorktreeCreate and WorktreeRemove plugin hooks being silently ignored

関連ドキュメント

Fixed
Hooks Plugins
プラグインや SDK 利用者によって登録された WorktreeCreate フックが無視される問題を修正しました。
英語原文を表示
Fixed WorktreeCreate hooks registered by plugins or SDK consumers being silently ignored

関連ドキュメント

v2.1.50 (1件)

Added
Hooks
WorktreeCreateおよびWorktreeRemoveフックイベントが追加され、エージェントのワークツリー分離がワークツリーを作成または削除する際にカスタムVCSのセットアップとティアダウンが可能になりました。
英語原文を表示
Added WorktreeCreate and WorktreeRemove hook events, enabling custom VCS setup and teardown when agent worktree isolation creates or removes worktrees.

変更前

ワークツリーの作成・削除時にカスタムVCSのセットアップ/ティアダウンを行う機能がありませんでした。VCSの初期化やクリーンアップを自動化したい場合に、手動での対応が必要でした。

変更後

ワークツリーの作成・削除時にカスタムVCSのセットアップ/ティアダウンを行えるようになりました。これにより、VCSの初期化やクリーンアップといった定型作業を自動化できます。

ユーザーへの恩恵

VCSのセットアップとティアダウンを自動化することで、開発者はワークツリーのライフサイクル管理にかかる手間を省き、より効率的に開発を進めることができます。

関連ドキュメント