Session status glyph
A small status glyph for a launcher session row. Recent, running, failed, and archived map onto StatusDot; pinned rows replace that lifecycle dot with an accent pin.
Included in the single kansho full pack. Components are not offered as separate installs.
Lifecycle states
recent · running · failed · archivedPinned
The accent pin replaces the lifecycle dotUsage
Guidance- Use it as the leading glyph on a launcher session row.
- Use pinned when the pin should replace the lifecycle dot in this compact slot.
- Rely on the glyph colour alone — it carries an aria-label twin.
- Reuse it for agent run status — that is the agent status glyph.
- When to use
- A compact lifecycle indicator on a session list row.
- When not to
- Agent run or tool status — use the shared status glyph.
Accessibility
Screen readerAnnounces
- The glyph is a role=img with an aria-label naming the lifecycle state.
- The pinned adornment is announced as "Pinned".
Props
API reference| Prop | Type | Default | Description |
|---|---|---|---|
| statusrequired | SessionLifecycle | — | recent | running | failed | archived. |
| pinned | boolean | false | Replace the lifecycle dot with an accent pin glyph. |
Component documentation
Session Status Glyph
components/workspace/session-status-glyph.tsxPurpose
Shows recent, running, failed, or archived session lifecycle with an optional pin adornment.
Appropriate use
Use beside a session label when a small explicit lifecycle cue is required.
Example
components/workspace/session-status-glyph.tsx has a representative live example in the "Lifecycle states" section on /components/session-status-glyph.
States
Lifecycle states are recent, running, failed, and archived; when pinned is true, Pinned replaces the lifecycle glyph rather than appearing beside it.
API and props
SessionStatusGlyph accepts status, pinned, and className and exports the lifecycle-to-status label maps.
Dependencies
Direct imports are React, Lucide icons, StatusDot, shared status types, workspace types, and cn.
Accessibility
The unpinned lifecycle dot is wrapped in a named image; the pinned branch replaces it with a named Pinned image, so colour is not the only cue.
Limitations
It does not announce status changes or provide tooltip/context for why a session failed or was pinned.
Source
Source: components/workspace/session-status-glyph.tsx.
Full pack
components/workspace/session-status-glyph.tsx is documented at /components/session-status-glyph and installs only through the single Kansho full pack; no individual component install is offered.