Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.302 ·

Background hooks get a grace period to finish before being cancelled

Claude Code now waits a short grace period for background hooks of an event to finish, then cancels the rest and drops unreadable results

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

Unclear Whether this changes how background hooks finish or only reorganises existing behaviour is not clear.

What

Hooks are your own commands that Claude Code runs at set moments, and async hooks run in the background without holding Claude Code up. Claude Code now handles unfinished async hooks for an event like this:

  • it waits a short grace period for them to finish
  • it cancels any still running after that
  • it reads each finished hook's result, and if it cannot, logs that and drops the result
Why

It may change how background hooks wrap up, for example when a session ends. If an async hook's output goes missing, a failed read at the end is one reason.

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 doubtWhether this changes how background hooks finish or only reorganises existing behaviour is not clear.

See this entry in the whole of v2.1.302 →

Feedback