Skip to content
Back

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-status
CClaudeWorkingRunning cargo test -p auth1m 23s
The code is part of Oxyn Pro

The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

Get Pro

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.

Terminal
oxyn add agent-status

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Acting

Working with a live timer.

CClaudeWorkingRunning cargo test -p auth1m 23s
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Waiting

Needs you.

CClaudeNeeds youApprove pushing to main?1m 23s
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Card

Card.

CClaudeThinkingPlanning the migration1m 23s
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Error

Error.

CClaudeErrorRate limited by GitHub1m 23s
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

AgentStatus

PropTypeDefaultDescription
namerequiredString—Agent name.
staterequiredString—`idle` · `thinking` · `acting` · `waiting` · `error` · `done`.
activityOption<String>Default::default()What it does right now.
startedOption<ClockMs>Default::default()Started at (live timer).
nowrequiredClockMs—Shared clock.
variantString"pill"`pill` · `card` · `inline`.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
—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 AgentStatus from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: AgentStatusEl in oxyn_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.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI