Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.269 ·

New plugin hook events for tool checks, config changes, and sessions

Plugins/hooks can now react to tool.check, config.set, config.describe, session.attach, session.detach, and plugin.register events

TierNothing to try yethow much it should matter to you
Useful4my rating, 1 to 5
Signal3worth watching, 1 to 5
AreaPlugin Hookswhat it touches
KindNew Featuresin v2.1.269,
Group of 4 Nothing to try yet Notable No documentation found

Plugins/hooks can now react to tool.check, config.set, config.describe, session.attach, session.detach, and plugin.register events

What

  • The plugin hook system (the mechanism plugin scripts use to observe or intervene in Claude Code's behavior) adds new event types: tool.check (a dry-run check of whether a tool call would be permitted, without actually running it), config.set and config.describe (observe or gate configuration changes), session.attach and session.detach (fired when a session's viewport/surface, or client, attaches or detaches, carrying details like surface, clientId, and detach reason), and plugin.register.
  • tool.check handlers can respond with a decision of allow, ask, or deny (plus an optional reason/rule) for a given tool call.
  • The old turn.complete handler was replaced with a new implementation.
  • The SDK's own request-normalization layer also gained tool.check, config.set, and config.describe as pass-through operations, alongside existing ones like tool.describe and command.run.

Why These new event types let plugins and hooks do more than just intercept tool calls after the fact — they can pre-check permissions, watch config changes, and track session lifecycle, making more sophisticated plugin behavior possible.

Read from
Names in the bundletool.checkconfig.setconfig.describesession.attachsession.detach
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 doubtThe finding does not say what plugin-facing capability these new events enable beyond their names and handler wiring.

See this entry in the whole of v2.1.269 →

Feedback