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-indicatorThe 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
- 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.
oxyn add status-indicatorUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Pill
Dot, label and a hairline pill.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Inline
No surface.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Dot
Dot alone; the label is the accessible name.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
All states
Every state.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
StatusIndicator
| Prop | Type | Default | Description |
|---|---|---|---|
staterequired | AgentState | — | The agent state. |
now | ClockMs | Default::default() | Shared clock time (for loop phase and stall durations). |
pack | String | "neutral" | Verb pack id (`neutral`, `coder`, `terse`, `crm`). |
variant | IndicatorVariant | Default::default() | Variant. |
size | IndicatorSize | Default::default() | Size. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| — | 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::Statuswith 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.defaultonsurface.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 readsclock.phase; CSS uses a negativeanimation-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
| Transition | Duration | Easing | Rate |
|---|---|---|---|
| Busy pulse | loop.pulse 2000 ms | cosine | clock rate (≤ 60 fps, 20 unfocused) |
| Submitted pulse | loop.base 1000 ms | cosine | same |
| Waiting breathe | loop.calm 2000 ms | cosine | same |
| Stall ramp | dur.stall.ramp 2000 ms | ease.linear | once |
| Stall recover | dur.stall.recover 200 ms | ease.out | once |
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+inlineordot, with thetersepack. - 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
StatusIndicatorfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
StatusIndicatorElinoxyn_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.