Skip to content
Back

Status indicatorPro

A dot and a label for any of the 13 agent states, as a pill, inline or a dot alone; the verb comes from a verb pack and stalls show how long.

oxyn add status-indicator
Running cargo test
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

  • The smallest honest answer to "what is the agent doing?": a dot and a few words.
  • It sits in thread headers, sidebar rows, tab strips, sub-agent rows and the corner of a chat window.
  • Larger surfaces (status strip, verb cycler, loaders) build on the same AgentState and the same words.

When not to use

  • Fourteen text-glyph loaders (braille, sand, blocks, scanner…) that settle into a check, a warning or a cross when the agent finishes, waits or fails: use Glyph loader instead.
  • A small turning arc for work that runs right now, plus dots, ray and orbit styles: use Spinner instead.
  • A pixel-grid loader with a shimmering verb and the elapsed time: use Loading state instead.

Installation

Status indicator 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 status-indicator

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

Pill

Dot, label and a hairline pill.

Running cargo test
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

Inline

No surface.

Thinking
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

Dot

Dot alone; the label is the accessible name.

Waiting for you
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

All states

Every state.

idleIdle
composingDrafting
submittedSending
thinkingThinking
streamingWriting
tool-runningRunning cargo test
awaiting-approvalWaiting for you
queued2 queued
steeringSteering
stalledThinking
doneWorked for 1m 12s
errorStopped · timeout
cancelledInterrupted after 42s
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

StatusIndicator

PropTypeDefaultDescription
staterequiredAgentState—The agent state.
nowClockMsDefault::default()Shared clock time (for loop phase and stall durations).
packString"neutral"Verb pack id (`neutral`, `coder`, `terse`, `crm`).
variantIndicatorVariantDefault::default()Variant.
sizeIndicatorSizeDefault::default()Size.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
—Not focusable

Accessibility

  • role=status with aria-live=polite, so state changes are announced.
  • The dot variant keeps the label as its accessible name.
  • The pulse is removed under prefers-reduced-motion.
From the spec
  • Dot is decorative; meaning is always in words (never colour alone).
  • Web: a visually hidden role="status" aria-live="polite" span carries the label. During a hard stall it says "No response" without the ticking number, so screen readers hear each state once.
  • GPUI: Role::Status with the label as the accessible name.
  • Reduced motion: no pulse, breathe or ramp; the dot is static at full opacity.
  • Contrast: the label is fg.default on surface.raised (checked in docs/tokens.md §8); the dot is a non-text indicator (WCAG 1.4.11, 3:1), with its meaning repeated in the label.

Motion & interaction

  • Pulse is a cosine on opacity, phase-locked to the window's MotionClock, so every indicator in a window breathes together (GPUI reads clock.phase; CSS uses a negative animation-delay).
  • Stall ramp runs once on entering soft stall; recovery snaps back over dur.stall.recover (200 ms).
  • Label changes swap instantly here. Animated verb swaps are the verb cycler's job.
Timing
TransitionDurationEasingRate
Busy pulseloop.pulse 2000 mscosineclock rate (≤ 60 fps, 20 unfocused)
Submitted pulseloop.base 1000 mscosinesame
Waiting breatheloop.calm 2000 mscosinesame
Stall rampdur.stall.ramp 2000 msease.linearonce
Stall recoverdur.stall.recover 200 msease.outonce

Photosensitivity: every luminance loop has a period ≥ motion.loop.luminance-min-period (1000 ms); tested in oxyn-core.

Responsive behaviour

  • small (6 px dot, 12 px text) for dense rows; medium (8 px, 13 px) elsewhere.
Edge cases (spec)
  • Long targets ("Reading a_very_long_file_name.rs"): the label never wraps; hosts clip with an ellipsis. The adapter shortens targets (status-text.md §5.3).
  • Tiny rows (16–20 px): use sm + inline or dot, with the terse pack.
  • Hidden windows: loops stop (clock rule); the label stays correct when shown again.
  • RTL: the dot sits at the inline start (flex follows direction).

Notes for AI

  • Import StatusIndicator from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: StatusIndicatorEl in oxyn_gpui.
  • Props to set first: state.
  • 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