[DOCS] [Agent view] "From inside a session" backgrounding section omits that the session's `/color` carries over to the new row
Documentation Type
Unclear/confusing documentation
Documentation Location
https://code.claude.com/docs/en/agent-view#from-inside-a-session
Section/Topic
"From inside a session" subsection under "Dispatch new agents" (and the related "Background this session?" / /background / ← flow described earlier in the page).
Current Documentation
The "From inside a session" section enumerates what carries over when you background a session with ← or /background. The current prose says:
Backgrounding from an interactive session starts a fresh process that resumes from the saved conversation, and in-flight work moves to it: running background shell commands, backgrounded subagents, dynamic workflows, and scheduled tasks you created with/loopcarry over to the background session and keep running there. ... Configuration flags from the original launch carry through to the backgrounded session, so its MCP servers, settings, and fallback model remain in effect:--mcp-configand--strict-mcp-config--settings--add-dir--plugin-dir--fallback-model--allow-dangerously-skip-permissionsDirectories you added during the session with/add-diralso carry through.
The /color row-tint behavior is mentioned only in two places:
- A single clause in the "Monitor sessions with agent view" section: "The name is tinted with the color set by
/colorin that session. As of v2.1.199 the color carries over when you [background a session](#from-inside-a-session) with←or/background."
- One line in the version-history table: "Backgrounding a session with
←or/backgroundcarries its/colorover to the new row."
What's Wrong or Missing?
A. "From inside a session" section silently drops /color
The "From inside a session" subsection is where users learn what state persists across a background. It explicitly enumerates carried-over work (running background shell commands, backgrounded subagents, dynamic workflows, /loop tasks), configuration flags from the original launch, and /add-dir directories. The session's /color — which is in-session state that the user set with a slash command, not a launch flag — is not mentioned at all in this enumeration, even though v2.1.199 makes it carry over to the new row.
B. Cross-reference chain is one-way and easy to miss
The "Monitor sessions with agent view" mention on the row-tint paragraph does link to "From inside a session", but a user reading "From inside a session" top-to-bottom will not find any reciprocal note about /color. The version-history entry is buried in a long table of release notes and is not surfaced where users are deciding whether to background.
C. /color command reference doesn't address backgrounding at all
/color [color|default] is documented in the interactive command reference (https://code.claude.com/docs/en/commands), but its description — "Set the prompt bar color for the current session" — does not say the color persists across a ← / /background transition or that the color sets the row tint in agent view.
Suggested Improvement
Add a sentence to the "From inside a session" section that explicitly lists /color alongside the other carried-over session state. For example, between the in-flight-work paragraph and the configuration-flags list, add:
The session's row tint also carries through: any color you set with /color is applied to the new background row as of v2.1.199, so the session keeps its visual identity in agent view after backgrounding.
Optionally, extend the /color command entry in the interactive command reference (https://code.claude.com/docs/en/commands) with a clause such as:
The color you set persists across←and/background: the backgrounded session's row keeps the same tint in agent view.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/agent-view | 297–318 | "From inside a session" section enumerates carried-over state; /color is missing from the list |
| https://code.claude.com/docs/en/agent-view | 75 | Row-tint paragraph carries a min-version clause that links back, but the link target never reciprocates |
| https://code.claude.com/docs/en/agent-view | 652 | Version-history table mentions the fix in one sentence among many |
| https://code.claude.com/docs/en/commands | 61 | /color command reference does not describe backgrounding behavior |
Total scope: 4 page locations in 2 pages, with the primary fix location being the "From inside a session" enumeration.
Version where behavior changed: v2.1.199. The fix corrects a regression where backgrounding via ← or /background removed the session's /color from the agent view row. Earlier versions may still drop the color when backgrounding.