claude-code - 💡(How to fix) Fix [DOCS] Agent view docs omit the awaiting-input count in the `claude agents` terminal tab title [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#60690Fetched 2026-05-20 03:52:02
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
Participants
Timeline (top)
labeled ×4
RAW_BUFFERClick to expand / collapse

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:

PageLine(s)Context
https://code.claude.com/docs/en/agent-view73-126Documents agent-view rows and the Needs input state, but not the tab-title attention indicator added in v2.1.145

Cross-references:

PageLine(s)Context
https://code.claude.com/docs/en/cli-reference87General note that session names appear in the terminal title
https://code.claude.com/docs/en/env-vars172CLAUDE_CODE_DISABLE_TERMINAL_TITLE opt-out for automatic title updates

Total scope: 1 primary page affected, with 2 related cross-reference pages

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [DOCS] Agent view docs omit the awaiting-input count in the `claude agents` terminal tab title [1 participants]