Skip to content
Back

Agent timelinePro

Replays a multi-agent run on one clock: a row per agent, links where work passes between them, and a playhead sweeping over thinking, tool and idle spans as the totals for time, tokens and spend tick up.

oxyn add agent-timeline

Checkout conversion drop on Oct 14

0.0s · 0 tokens · $0.00 · 1 agent working

OrchestratorClaude Opus 4.1
ResearcherClaude Sonnet 4.5
AnalystGPT-5 mini
CheckerGemini 2.5 Flash
WriterMistral Medium
  • Thinking
  • Tool call
  • Waiting
  • Handoff
  • Failed
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

  • Replay one orchestrated run on a shared time axis: the orchestrator on top, its subagents below, so a builder sees who worked when, what each waited on, where handoffs happened and what the run cost.

When not to use

Installation

Agent timeline 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-timeline

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

Replay

The run replays from zero.

Checkout conversion drop on Oct 14

0.0s · 0 tokens · $0.00 · 1 agent working

OrchestratorClaude Opus 4.1
ResearcherClaude Sonnet 4.5
AnalystGPT-5 mini
CheckerGemini 2.5 Flash
WriterMistral Medium
  • Thinking
  • Tool call
  • Waiting
  • Handoff
  • Failed
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

Finished

A finished run, ready to replay, with cost per span (Oxyn extra).

Checkout conversion drop on Oct 14

5 agents · 26.4s · 1.2x faster than sequential · $0.22

OrchestratorClaude Opus 4.1
ResearcherClaude Sonnet 4.5
AnalystGPT-5 mini
CheckerGemini 2.5 Flash
WriterMistral Medium
  • Thinking
  • Tool call
  • Waiting
  • Handoff
  • Failed
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

Waterfall

One row per span in start order (Oxyn extra).

Checkout conversion drop on Oct 14

5 agents · 26.4s · 1.2x faster than sequential · $0.22

Planned the investigation
Waiting on the researcher and analyst
Read six release notes
Queried checkout events
Pulled conversion by step
Summarised what changed
Found the drop at the payment step
Matched the drop to a deploy
Combined the findings
Waiting on the writer
Drafted the incident summary
Reviewed and sent it
  • Thinking
  • Tool call
  • Waiting
  • Handoff
  • Failed
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

Live

Following a run in progress: no playback controls.

Checkout conversion drop on Oct 14

0.0s · 0 tokens · $0.00 · 1 agent working

Live
OrchestratorClaude Opus 4.1
ResearcherClaude Sonnet 4.5
AnalystGPT-5 mini
CheckerGemini 2.5 Flash
WriterMistral Medium
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

AgentTimeline

PropTypeDefaultDescription
nowrequiredClockMs—Host clock.
titleString"Checkout conversion drop on Oct 14"Heading.
viewString"lanes"`lanes` (one row per agent) or `waterfall` (one row per span, Oxyn extra).
autoplaybooltrueReplay from zero on mount; otherwise the run renders finished.
live_runboolDefault::default()Follow a run in progress (no playback controls).
show_costboolDefault::default()Show each span's cost on the bar and in the card (Oxyn extra).
speedu641Starting speed (1 or 2).

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabThe spans (one tab stop), the scrubber, then play, restart and speed
←or→Previous or next span in the row; on the scrubber half a second (Shift: five)
↑or↓Jump to the closest span one row up or down
HomeorEndFirst or last span in the row; on the scrubber the start or end
Page upordownOn the scrubber, five seconds
EnterorSpacePin the span and highlight its handoff path; again to unpin
EscapeUnpin

Accessibility

  • The root is a labelled section; spans are buttons named by agent, kind, tool, failure, what it did, time range and tokens; aria-pressed marks the pinned span.
  • One tab stop for the whole chart; arrows pick spans inside it.
  • The scrubber is a range input that reads out position and length (12.4s of 26.4s).
  • A failed span carries a cross and the word Failed as well as red; a finished run ends on a check next to its totals.
  • Replay, pause and the closing totals go to the polite region; the ticking header itself stays quiet.
From the spec

The chart is a labelled group; each span is a button naming agent, kind, start and duration. Space toggles play, Home restarts, Left/Right step the playhead. Finish is announced in the polite live region. Every action returns the line the polite live region announces. The focus outline shows only for keyboard focus.

Motion & interaction

Spans grow from their left edge as the playhead passes them; thinking spans are a tint of the agent colour, tool calls solid, waiting hatched. Handoff connectors draw between rows when their source span ends. Hover or focus on a span lifts it and shows its readout; the header numbers roll, never jump. Speed chip cycles 1x / 2x / 4x.

Timing

Everything on screen is derived from the host clock now (no timers in the component), so playback, tests and the GPUI view agree.

TransitionDurationEasing
Playheadderived from the host clock, 1x = real run timelinear
Span growfollows the playheadlinear
Header numbers160 ms roll per changeease-out
Finish summary220 ms crossfadeease-out

Reduced motion: streamed text and moves appear at their end state; progress still advances, without travel animation.

Responsive behaviour

  • The label column is 180 px wide; below 560 px it keeps only the dot and agent name, and the model shows in the span card.
  • The plot keeps a 300 px minimum and scrolls inside its own frame (thin scrollbar) with labels pinned.
  • Tabular figures keep the totals the same width while they climb.
Edge cases (spec)

Long agent names truncate with an ellipsis and keep the full name in the label. Under 640 px the label column narrows to marks only and the axis keeps 4 ticks. The waterfall variant lists one row per span for narrow panels. RTL mirrors the label column but keeps time running left to right. Checked at 1440, 768 and 390 px in light and dark with no text overlap. Chrome is monochrome grey; colour is semantic only (success, warning, danger, info) plus the providers' coloured brand marks.

Notes for AI

  • Import AgentTimeline from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: AiKitView 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