[DOCS] Agent view docs do not mention that `/login` opens the sign-in dialog from the `claude agents` view (v2.1.198)
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/agent-view
Section/Topic
- The agent view page section that describes what happens when a background dispatch or session fails because of missing credentials; specifically the block that begins with "If a background dispatch fails with
Could not resolve authentication method..."
Current Documentation
The troubleshooting block on the agent view page reads:
If a background dispatch fails withCould not resolve authentication methodwhile interactive sessions authenticate normally, the worker that received the dispatch did not pick up credentials. The supervisor supplies a fresh credential snapshot when it assigns a [pre-warmed worker](#the-supervisor-process), so this error means no stored credential was available to the supervisor process itself. Confirm you have run/loginor configured an API key, then stop the supervisor:
This implies the user has to leave agent view to run /login from elsewhere and then restart the supervisor.
What's Wrong or Missing?
The release notes for v2.1.198 add direct sign-in support from inside agent view:
/loginnow opens the sign-in dialog from theclaude agentsview instead of saying it isn't available
The current troubleshooting flow tells users to leave the view, run /login, then restart the supervisor. After v2.1.198, users can run /login directly from agent view to open the sign-in dialog. The page does not mention that pathway.
Suggested Improvement
Before:
If a background dispatch fails withCould not resolve authentication methodwhile interactive sessions authenticate normally, the worker that received the dispatch did not pick up credentials. The supervisor supplies a fresh credential snapshot when it assigns a [pre-warmed worker](#the-supervisor-process), so this error means no stored credential was available to the supervisor process itself. Confirm you have run/loginor configured an API key, then stop the supervisor:
After:
If a background dispatch fails withCould not resolve authentication methodwhile interactive sessions authenticate normally, the worker that received the dispatch did not pick up credentials. The supervisor supplies a fresh credential snapshot when it assigns a [pre-warmed worker](#the-supervisor-process), so this error means no stored credential was available to the supervisor process itself. As of v2.1.198, run/logindirectly from the agent view to open the sign-in dialog instead of leaving the view. If you authenticate with an environment variable rather than/login, run the next command from a shell where the variable is set, then stop and restart the supervisor:
Impact
Medium - Makes feature difficult to understand
Additional Context
Related v2.1.198 change:
/loginnow opens the sign-in dialog from theclaude agentsview instead of saying it isn't available
The /login row in the commands reference does not mention the new in-view entry point either, so the recovery flow is the only place that reads naturally for this guidance.
Affected Pages:
| Page | Context |
|---|---|
| https://code.claude.com/docs/en/agent-view | Authentication troubleshooting block that points users away from agent view |