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

TierUnder the hoodhow much it should matter to you
Useful1my rating, 1 to 5
Signal1worth watching, 1 to 5
AreaSDKwhat it touches
KindInternal Changesin v2.1.269,
Group of 4 Under the hood 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.

See this entry in the whole of v2.1.269 →

Feedback