claude-code - 💡(How to fix) Fix Agent view: purple/blue indicator color undocumented

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/agent-view#quick-start

Section/Topic

Agent view — Monitor sessions with agent view (state indicators table)

Current Documentation

The docs include this state indicator table:

┌───────────┬─────────────┬───────────────────────────────────────────────────────────┐ │ Indicator │ State │ What it means │ ├───────────┼─────────────┼───────────────────────────────────────────────────────────┤ │ Animated │ Working │ Claude is actively running tools or generating a response │ ├───────────┼─────────────┼───────────────────────────────────────────────────────────┤ │ Yellow │ Needs input │ Claude is waiting for your input │ ├───────────┼─────────────┼───────────────────────────────────────────────────────────┤ │ Dimmed │ Idle │ The session is waiting for input but isn't blocked │ ├───────────┼─────────────┼───────────────────────────────────────────────────────────┤ │ Green │ Completed │ The task finished successfully │ ├───────────┼─────────────┼───────────────────────────────────────────────────────────┤ │ Red │ Failed │ The task ended with an error │ ├───────────┼─────────────┼───────────────────────────────────────────────────────────┤ │ Grey │ Stopped │ The session was stopped │ └───────────┴─────────────┴───────────────────────────────────────────────────────────┘ Purple/blue is not listed.

What's Wrong or Missing?

A purple or blue dot appears as the left-side indicator on some completed sessions, along with what appears to be a numeric badge at the end of the row (e.g. 3 ●). Neither the color nor the badge count is explained anywhere in the documentation. Users have no way to know what this state means or what action (if any) is expected.

<img width="2260" height="1358" alt="Image" src="https://github.com/user-attachments/assets/8422cecf-f965-4f2f-8192-81d271eeb972" />

Suggested Improvement

Add a row to the state indicators table documenting the purple/blue indicator and what the numeric badge represents. If the badge is an unread message count, clarify what triggers it and how to clear it (e.g., opening the peek panel or attaching to the session).

Impact

Medium - Makes feature difficult to understand

Additional Context

Observed on Claude Code v2.1.139, macOS. The purple dot appeared on a session in the Completed group that had been completed since the prior day. The session had been previously viewed, so it's unclear what triggered the unread state or how to dismiss it.