Follow Discord
Sweep 29 Sep 2026 · 18:10Z Build v2.1.285 506 read Stable v2.1.280 Latest v2.1.285 Next v2.1.285 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.285 ·

Headless SDK sessions send plugin UI events and requests to the host app

Headless stream-json sessions now send ui_* messages (toasts, status, panes, prompt fill and more) so a host app can show plugin interface pieces

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

What

A headless session is Claude Code running without its own screen, driven by another program (the host) through the SDK with stream-json output. Plugin interface actions there used to do nothing but log "no notification bar in a headless session". Now they are passed to the host:

  • System messages with subtypes ui_toast, ui_status, ui_invalidate, ui_log, ui_panes, ui_scroll and ui_focus. The last five are sent only when a check passes. Before, only commands_changed was sent.
  • Requests the host answers: ui_copy, ui_prompt_read, ui_prompt_fill and ui_prompt_suggest, sent on non-remote connections. If an answer is shaped like an error and is not from the expected client, it is ignored and the request keeps waiting.
  • An allowlist of message subtypes now includes these ui_* subtypes and session_title_changed.
  • New hooks for connecting and resolving plugin MCP servers.

In the same area, reconnect and retry delays now go through one shared helper with random variation of 0.25 either way, and errors when waking a worker map to reasons such as wake_unsupported_host.

Why

A host app can now show plugin notifications, status and panes, and let plugins read or fill in the prompt box. This only has an effect if the host answers these messages.

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 doubtIt is not clear which host apps answer these requests, or which plugin features send them.

See this entry in the whole of v2.1.285 →

Feedback