Agent statusPro
Who is working and how: a state dot on the agent's avatar (idle, thinking, working, needs you, error, done), what it does right now shimmering, and for how long.
oxyn add agent-statusThe preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
Rendered from Rust at build time · goes live when visible
When to use
- Who is working and how: the agent's avatar with a state dot (idle, thinking, working, needs you, error, done), its name and state, what it does right now (shimmering while busy) and a live timer.
- Pill, card or inline.
When not to use
- An agent asks before it acts: use Approval Card instead.
- Several open requests in one card: use Approval pager instead.
- An agent's question in its own card above the composer: use Decision Card instead.
Installation
Agent status is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.
oxyn add agent-statusUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Acting
Working with a live timer.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Waiting
Needs you.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Card
Card.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Error
Error.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
AgentStatus
| Prop | Type | Default | Description |
|---|---|---|---|
namerequired | String | — | Agent name. |
staterequired | String | — | `idle` · `thinking` · `acting` · `waiting` · `error` · `done`. |
activity | Option<String> | Default::default() | What it does right now. |
started | Option<ClockMs> | Default::default() | Started at (live timer). |
nowrequired | ClockMs | — | Shared clock. |
variant | String | "pill" | `pill` · `card` · `inline`. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| — | Not interactive |
Accessibility
- role=status, polite: state changes are announced once.
From the spec
- role=status, polite.
Motion & interaction
Timing
- Reduced motion: no entrance rise, no shimmer (static muted text), rings and bars jump to their value.
Responsive behaviour
- Activity truncates first.
Edge cases (spec)
- Activity truncates first.
Notes for AI
- Import
AgentStatusfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
AgentStatusElinoxyn_gpui. - Props to set first:
name,state,now. - It reads a clock (
now) for live timers; pass one clock for the whole page rather than one per component. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.