Run monitorPro
One agent at work as a card – the current step with a clock and the bill so far, a time strip, the finished steps with each tool's logo, the exact command when it needs an OK, and a fold into a small bar.
oxyn add run-monitorThe 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
- One agent at work as a card: its current step with a clock and the bill so far, a time strip and the finished steps with each tool's logo, the exact command when it needs an OK, and a fold into a small bar.
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
Run monitor 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 run-monitorUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Default
Steps roll through the well with a clock and the bill so far, finished ones drop into the list, the card stops to ask before publishing (Enter allows, Esc declines), then finishes green.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Waiting
Needs you: the exact command in the well, Decline and Allow in the foot.
gh release create v2.4.00:09Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Details
A finished step clicked: when it started, how long it took, its share of the run and what it touched.
- Built the preview in 33sTerminal
- Started
- +0:06
- Took
- 2.4s
- Share
- 20%
- State
- Done
A clean build with every test passing
npm run build
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Failed
Failed: the step in red, what went wrong and Try again.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Folded
Folded into the small bar with the tools it used and how long it took.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Classic
Classic style: rounder card, bordered tiles and the controls on a tray.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
RunMonitor
| Prop | Type | Default | Description |
|---|---|---|---|
scene | Option<MonitorScene> | Default::default() | Your own run (the demo's when `None`). |
at | Option<u64> | Default::default() | Freeze the demo this many ms into a pass. |
failed | bool | Default::default() | Show the demo's failed run. |
default_folded | bool | Default::default() | Start folded, as the small bar. |
open | String | Default::default() | A step whose details are open at the start (id). |
nowrequired | ClockMs | — | The clock. |
style | String | Default::default() | `clean`, `classic`, or empty to follow `data-cstyle`. |
on_allow | EventHandler<()> | — | Allow while waiting (Enter does the same while the card has focus). |
on_decline | EventHandler<()> | — | Decline while waiting (Esc). |
on_pause | EventHandler<bool> | — | Pause (`true`) or resume (`false`). |
on_cancel | EventHandler<()> | — | Cancel a running run. |
on_retry | EventHandler<()> | — | Try again after a failure. |
on_open_log | Option<EventHandler<()>> | Default::default() | Log: jump to the full trace; shown when set. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Fold away, the finished steps, then the controls in the foot |
| Enter | While it waits and the card has focus: Allow |
| Esc | While it waits: Decline; with step details open, closes them |
| EnterorSpace | On a step: opens its details (focus moves to Close) |
Accessibility
- The card is a region named with the agent, its state and the current step; folded, the bar is one button with the same name.
- The time strip is one image labelled with every step and its time; finished steps are a list of buttons with aria-expanded.
- A step's details are a labelled dialog; the ask is announced when the card starts waiting.
Responsive behaviour
- A 340 px card that shrinks with its container; labels and the command ellipsize.
Edge cases (spec)
A fixed 340 px card that shrinks with its container; labels, the role and the command ellipsize.
Notes for AI
- Import
RunMonitorfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
RunMonitorElinoxyn_gpui. - Props to set first:
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.