WorktreeRemove
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 that a WorktreeCreate hook created is being removed
Anthropic's own wording. Read off Hooks reference, captured 2026-10-22.
In the changelogs
9Releases whose published page names WorktreeRemove.
-
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.268
claude rmgains a--force-remove-worktreeflag and rich refusal messagesclaude rmgets a--force-remove-worktreeflag and much more detailed refusal messagesfound in this entry's text
-
v2.1.268
New 'claude rm' subcommand flags for background sessions
claude rm gains --discard-unpushed and --force-remove-worktree flags for cleaning up background session worktrees
found in this entry's text
-
v2.1.268
WorktreeRemove hook result reporting overhauled
WorktreeRemove hook now reports whether it actually ran, removed the worktree, or failed
found in this entry's text, named in this entry
-
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
Worktree cleanup passes account state to the removal hook
Worktree removal now passes account state to your WorktreeRemove hook and the record-clearing call.
found in this entry's text
-
v2.1.187
WorktreeRemove hook — fallback now logged
found in this entry's text
- v2.1.92
-
v2.1.50
VCS-Agnostic Worktree Isolation via Hooks
found in this entry's text
First cited
3The earliest release whose published evidence quoted WorktreeRemove 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.
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.