[DOCS] [Agent view] "From inside a session" backgrounding section omits that the session's `/color` carries over to the new row

Open 💬 0 comments Opened Jul 3, 2026 by coygeek

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 /loop carry 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-config and --strict-mcp-config --settings --add-dir --plugin-dir --fallback-model --allow-dangerously-skip-permissions Directories you added during the session with /add-dir also carry through.

The /color row-tint behavior is mentioned only in two places:

  1. A single clause in the "Monitor sessions with agent view" section: "The name is tinted with the color set by /color in that session. As of v2.1.199 the color carries over when you [background a session](#from-inside-a-session) with or /background."
  1. One line in the version-history table: "Backgrounding a session with or /background carries its /color over 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.

View original on GitHub ↗