Skip to content
Back

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-monitor
Claude Opus 4.1Release agent · app v2.4$0.000Idle
Waiting to start
0/6
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

  • 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.

Terminal
oxyn add run-monitor

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

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.

Claude Opus 4.1Release agent · app v2.4$0.000Idle
Waiting to start
0/6
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: the exact command in the well, Decline and Allow in the foot.

Claude Opus 4.1Release agent · app v2.4$0.040Needs you
Ready to publishgh release create v2.4.00:09
4/6
Needs you: Ready to publish
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

Details

A finished step clicked: when it started, how long it took, its share of the run and what it touched.

Claude Opus 4.1Release agent · app v2.4$0.063Finished
Finished in 15s+214 −38 in 9 files
6/6
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

Failed

Failed: the step in red, what went wrong and Try again.

GPT-5Support agent · ticket #3107$0.020Failed
The orders sheet is locked
3/6
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

Folded

Folded into the small bar with the tools it used and how long it took.

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

Classic

Classic style: rounder card, bordered tiles and the controls on a tray.

Claude Opus 4.1Release agent · app v2.4$0.020Running
Writing the changelog0:04
3/6
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

RunMonitor

PropTypeDefaultDescription
sceneOption<MonitorScene>Default::default()Your own run (the demo's when `None`).
atOption<u64>Default::default()Freeze the demo this many ms into a pass.
failedboolDefault::default()Show the demo's failed run.
default_foldedboolDefault::default()Start folded, as the small bar.
openStringDefault::default()A step whose details are open at the start (id).
nowrequiredClockMs—The clock.
styleStringDefault::default()`clean`, `classic`, or empty to follow `data-cstyle`.
on_allowEventHandler<()>—Allow while waiting (Enter does the same while the card has focus).
on_declineEventHandler<()>—Decline while waiting (Esc).
on_pauseEventHandler<bool>—Pause (`true`) or resume (`false`).
on_cancelEventHandler<()>—Cancel a running run.
on_retryEventHandler<()>—Try again after a failure.
on_open_logOption<EventHandler<()>>Default::default()Log: jump to the full trace; shown when set.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabFold away, the finished steps, then the controls in the foot
EnterWhile it waits and the card has focus: Allow
EscWhile it waits: Decline; with step details open, closes them
EnterorSpaceOn 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 RunMonitor from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: RunMonitorEl in oxyn_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.

Guides

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