WorktreeCreate
A Claude Code hook event, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.
When a worktree is being created via --worktree, isolation: "worktree", or for a background session. Replaces default git behavior
Anthropic's own wording. Read off Hooks reference, captured 2026-10-22.
In the changelogs
14Releases whose published page names WorktreeCreate.
-
v2.1.300
Plugin WorktreeCreate hooks now run when you start with --worktree
Claude Code now loads plugins' WorktreeCreate hooks before creating a --worktree, so a plugin can handle worktree creation
found in this entry's text, named in this entry
-
v2.1.300
Plugin
WorktreeCreatehooks now run when starting with--worktreeStarting with
--worktreenow sets up plugin worktree hooks first, so a plugin'sWorktreeCreatehook can runfound in this entry's text, named in this entry
-
v2.1.295
A new setting limits what your own skills, agents and hooks can do
Setting CLAUDE_CODE_RESTRICT_PERSONAL_CONFIG stops your own skills, agents and hooks from widening permissions, and makes key hooks required
found in this entry's text
-
v2.1.284
claude remote-control --helpnow describes the trust prompt and worktree needsThe
claude remote-controlhelp no longer says to runclaudefirst to trust a folder, and notes what worktree mode needsfound in this entry's text
-
v2.1.281
/batch works outside a git repository when a WorktreeCreate hook is configured
/batchnow runs outside a git repository when aWorktreeCreatehook is configured, publishing through the project's own version controlfound in this entry's text, named in this entry
-
v2.1.265
WorktreeCreate hook failure no longer throws when no hook is configured
Creating a worktree no longer errors when no WorktreeCreate hook is configured at all
found in this entry's text, named in this entry
-
v2.1.265
Hook engine reworked into explicit core/managed layering with unified result merging
Hook execution engine rebuilt with a clearer core/managed split and unified result merging
found in this entry's text, named in this entry
-
v2.1.265
WorktreeCreate hook path now conditionally used via Cwt() instead of hX()
The condition for using a WorktreeCreate hook instead of git's default was renamed and restructured
found in this entry's text
-
v2.1.265
New hook events: WorktreeCreate / WorktreeRemove now gate feature availability via eE()
Worktree create/remove UI now also checks a broader capability gate, not just whether hooks are registered
found in this entry's text, named in this entry
-
v2.1.242
Managed hook skip message now says SDK callback hooks still run
The disableAllHooks notice now says SDK callback hooks still run while configured hooks are skipped.
found in this entry's text
-
v2.1.229
Hooks are handed a session object instead of reading globals
Hooks now get an explicit session with id, working directory and project root instead of guessing from globals.
found in this entry's text
-
v2.1.85
Worktree Support for Non-Git VCS
found in this entry's text
-
v2.1.84
WorktreeCreate Hook Output
found in this entry's text
-
v2.1.50
VCS-Agnostic Worktree Isolation via Hooks
found in this entry's text
First cited
12The earliest release whose published evidence quoted WorktreeCreate was v2.1.50, 20 Feb 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
6 further spans in the ledger name it. The list above is the earliest first and stops at 6.
Presence across releases
0The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the hook event does. All hook events.