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

Claude Code v2.1.246 ·

Headless idle detection now waits for background tasks and undelivered notifications

Headless runs no longer look finished while background tasks or undelivered notifications remain.

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

In print/headless mode, the check that decides a session has gone idle previously only looked for no active turn and nothing in flight. It now also requires no live background tasks, no active team context, and no pending task notification, so a headless run with background work or an undelivered task notification no longer looks finished.

Details
  • Idle is computed from the current task list plus outstanding waits and the current time, and reported under the existing cli_idle_gate_report_idle event.
  • Extra diagnostics on this path are only emitted when the environment variable CLAUDE_CODE_BG_TASKS_REPORT_RUNNING is set.
  • The plugin and agent registry refresh function now takes an options bag that it forwards to the agent-definition loader.
Evidence

cli_idle_gate_report_idle

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

See this entry in the whole of v2.1.246 →

Feedback