[DOCS] Agent view docs omit the awaiting-input count in the `claude agents` terminal tab title
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/agent-view
Section/Topic
"Monitor sessions with agent view" / "Read session state"
Current Documentation
The page currently explains in-terminal status signals, but not the terminal-tab-title signal:
Agent view, opened with claude agents, is one screen for all your background sessions: what's running, what needs your input, and what's done.
Run claude agents to open agent view. It takes over the full terminal and lists every session grouped by state, with pinned sessions and the ones that need you at the top. Each row shows the session's name, current activity, and how long ago it last changed.
| Needs input | Yellow | Claude is waiting on a specific question or permission decision from you |
What's Wrong or Missing?
Claude Code v2.1.145 added a new attention signal for claude agents: the terminal tab title now shows the count of sessions awaiting input, so an unfocused or alt-tabbed window can still tell you when an agent needs attention.
The agent view docs do not mention this behavior. As written, the page only documents the on-screen row states inside agent view, so users can miss that there is also an out-of-focus attention cue in the terminal tab title.
Suggested Improvement
Add a short note in the agent view guide that explains:
While claude agents is open, Claude Code also updates the terminal tab title. When one or more sessions are awaiting your input, the title includes that count so an unfocused window can still signal that something needs attention.
Add a cross-reference to the terminal-title opt-out so readers can discover the related setting:
If you prefer not to change terminal titles, set CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/agent-view | 73-126 | Documents agent-view rows and the Needs input state, but not the tab-title attention indicator added in v2.1.145 |
Cross-references:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/cli-reference | 87 | General note that session names appear in the terminal title |
| https://code.claude.com/docs/en/env-vars | 172 | CLAUDE_CODE_DISABLE_TERMINAL_TITLE opt-out for automatic title updates |
Total scope: 1 primary page affected, with 2 related cross-reference pages
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗