[DOCS] `claude daemon status` version-skew explanation added in v2.1.176 is not in `agent-view.md` or `cli-reference.md`

1. TITLE

claude daemon status version-skew explanation added in v2.1.176 is not in agent-view.md or cli-reference.md

2. WHAT KIND OF DOCUMENTATION ISSUE IS THIS?

• [x] Missing documentation (feature not documented)
• [ ] Unclear/confusing documentation
• [ ] Incorrect/outdated documentation
• [ ] Typo or formatting issue
• [ ] Missing code examples
• [ ] Broken links
• [ ] Other

3. WHERE DID YOU ENCOUNTER THIS ISSUE?

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

4. WHICH SPECIFIC SECTION OR TOPIC NEEDS IMPROVEMENT?

The "Inspect the supervisor" section in agent-view.md and the claude daemon status row in cli-reference.md.

5. CURRENT DOCUMENTATION

agent-view.md (Inspect section) currently says:

To inspect this state without reading the files directly, run claude daemon status. It reports whether the supervisor is reachable, its process ID and version, the socket directory, and how many background sessions are live.

cli-reference.md says:

claude daemon status | Print the background-session supervisor's state, version, socket directory, and worker count for diagnostics. Exits 1 if the supervisor isn't running.

Neither page mentions version-skew or what to do when the running supervisor's version differs from the active Claude Code binary.

6. WHAT'S WRONG OR MISSING?

v2.1.176 added a new diagnostic capability:

Background sessions now show clearer guidance when a window left open across an auto-update can't submit a reply, and claude daemon status explains version-skew behavior

After an auto-update, the supervisor on disk may be older than the new Claude Code binary, and users need a way to know whether to wait for the supervisor to respawn into the new version or to restart it manually. The current docs do not mention this scenario or what claude daemon status reports about it.

7. SUGGESTED IMPROVEMENT

Add a sentence to both pages describing the version-skew behavior. For agent-view.md:

When the running supervisor's version differs from the installed Claude Code binary after an auto-update, claude daemon status reports which side is ahead and notes that the supervisor will respawn into the new version on the next idle window. Run claude respawn --all to force every background session onto the new binary immediately.

For cli-reference.md:

claude daemon status ... If the supervisor's version differs from the installed Claude Code binary, the output calls out the skew and explains that the supervisor will respawn into the new version on the next idle window.

8. IMPACT

• [ ] High - Prevents users from using a feature
• [x] Medium - Makes feature difficult to understand
• [ ] Low - Minor confusion or inconvenience

9. ADDITIONAL CONTEXT

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/agent-view | Documents claude daemon status output fields; should mention version-skew |
| https://code.claude.com/docs/en/cli-reference | Documents the claude daemon status command; should mention version-skew |
| https://code.claude.com/docs/en/troubleshooting | Could cross-reference if "background session stuck on old version" troubleshooting is added |

Source: Changelog v2.1.176