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.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗