Follow Discord
Sweep 02 Oct 2026 · 18:55Z Build v2.1.288 509 read Stable v2.1.285 Latest v2.1.288 Next v2.1.288 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.288 ·

Claude Code says why a hook was not registered

Hooks that are skipped now come with a reason, such as a missing script or a script in an unread dot-folder

You'll notice Improvements
JSON All of v2.1.288
You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
HooksArea: what it touches
ImprovementsKind: in v2.1.288,
ImprovementsSection of the release
What

When a hook (a command set up to run automatically at certain moments) is not registered, Claude Code now gives a reason:

  • its script is in a dot-folder (a folder whose name starts with a dot) that this machine does not read hooks from, with advice to check the script and move it to ~/.claude/hooks
  • it would run through your CLAUDE_CODE_SHELL_PREFIX, which this machine cannot verify
  • its script is missing

A separate status reads that the hook is not registered yet and your next message tries again.

Why

If you define hooks, a skipped hook now comes with something you can act on instead of disappearing silently.

How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtWhere in Claude Code these reasons are shown is not established.

See this entry in the whole of v2.1.288 →

Feedback