[DOCS] Background-session docs omit `claude daemon status` diagnostics

[coygeek]

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/cli-reference

Section/Topic

CLI and troubleshooting documentation for background-session daemon diagnostics

Current Documentation

The docs currently list the background-session commands:

claude agents | Open agent view to monitor and dispatch parallel background sessions.

claude attach <id> | Attach to a background session in this terminal

claude logs <id> | Print recent output from a background session

claude respawn <id> | Restart a stopped background session with its conversation intact

claude rm <id> | Remove a background session from the list

claude stop <id> | Stop a background session

And the agent-view docs say:

Session state is stored under your Claude Code config directory.

~/.claude/daemon.log | Supervisor log

~/.claude/daemon/roster.json | List of running background sessions, used to reconnect after a restart

What's Wrong or Missing?

The v2.1.141 release notes indicate that claude daemon status is a supported diagnostic command and that /doctor uses the same daemon state on Windows, but the docs do not document claude daemon status anywhere.

That leaves a gap in the background-session troubleshooting story: the docs describe the supervisor, its on-disk files, and adjacent commands such as claude logs, but they do not tell users that there is a daemon-status command they can run to inspect this subsystem directly.

Because the v2.1.141 fix specifically improves how Windows users see locked or unreadable daemon pipe-key file errors, that diagnostics path is now user-visible but still undocumented.

Suggested Improvement

Add claude daemon status to the CLI reference and link to it from the background-session/agent-view troubleshooting docs.

The new entry should explain what subsystem it checks, when to use it instead of or alongside /doctor, and note that on Windows v2.1.141 and later it surfaces the underlying daemon pipe-key file access error instead of a generic failure.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Page	Line(s)	Context
https://code.claude.com/docs/en/cli-reference	27-38	Background-session command list includes claude agents, attach, logs, respawn, rm, and stop, but not claude daemon status
https://code.claude.com/docs/en/agent-view	334-339	Describes daemon state files (daemon.log, daemon/roster.json) without documenting a daemon-status command
https://code.claude.com/docs/en/commands	29, 62	/doctor is described generically, with no cross-reference to daemon diagnostics

Total scope: 3 pages affected

Version context: v2.1.141 release notes say claude daemon status and /doctor on Windows now surface the underlying daemon pipe-key file error when that key file is locked or unreadable.

[github-actions]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.