Follow Discord
Sweep 12 Nov 2026 · 23:00Z Build v2.1.323 540 read Stable v2.1.311 Latest v2.1.323 Next v2.1.323 Feeds RSS JSON llms.txt llms-full.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

Group of 4 Use it now No documentation found Internal Changes
JSON All of v2.1.269
Use it nowTier: how much it should matter to you
5Useful: my rating, 1 to 5
4Signal: worth watching, 1 to 5
SDKArea: what it touches
Internal ChangesKind: in v2.1.269,
What probably matters to youSection of the release

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