Relay trailPro
A task passed from agent to agent like a relay – at every handoff what went along to the next one, what got lost on the way, and a light running down the line as the card drops in.
oxyn add relay-trailGathers the sources, checks the facts and picks the angle.
Shapes the brief into a first draft in the house voice.
Tests each claim against its source before release.
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.
Rendered from Rust at build time · goes live when visible
When to use
- A task passed from agent to agent like a relay: at every handoff, what went along to the next agent and what got lost on the way.
- People can push a task on to a later agent and watch it travel down the relay.
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
Relay trail 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 relay-trailUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Default
The Researcher picks up the next task, hands it to the Writer and on to the Reviewer – a light runs along the lines, the card drops into its column and the costs tick up.
Gathers the sources, checks the facts and picks the angle.
Shapes the brief into a first draft in the house voice.
Tests each claim against its source before release.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Handing on
Frozen just after a handoff: the new card on top of the column, "With Writer" and the Writer drafting.
Gathers the sources, checks the facts and picks the angle.
Shapes the brief into a first draft in the house voice.
Tests each claim against its source before release.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Card open
A handoff card open in place: everything that went along, and the lost item struck through.
Gathers the sources, checks the facts and picks the angle.
Shapes the brief into a first draft in the house voice.
Tests each claim against its source before release.
- winback-brief.md
- 9 sources
- Open with the fix
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Lost item
The lost item open: why it got lost, and Add back.
Gathers the sources, checks the facts and picks the angle.
Shapes the brief into a first draft in the house voice.
Tests each claim against its source before release.
- winback-brief.md
- 9 sources
- Open with the fix
- Cut to fit the Writer's 32k context budget before the handoff.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Stacked
Below 620 px the relay stacks into one column: an agent, its handoff, the next agent.
Gathers the sources, checks the facts and picks the angle.
Shapes the brief into a first draft in the house voice.
Tests each claim against its source before release.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Classic
Classic style: visible borders, crisper corners and the column header in a filled band.
Gathers the sources, checks the facts and picks the angle.
Shapes the brief into a first draft in the house voice.
Tests each claim against its source before release.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
RelayTrail
| Prop | Type | Default | Description |
|---|---|---|---|
scene | Option<HandoffScene> | Default::default() | Your own relay (the demo's when `None`). |
at | Option<u64> | Default::default() | Freeze the demo at this many ms into a pass (a settled state). |
open | String | Default::default() | A handoff card open at the start (its id). |
open_item | String | Default::default() | A lost item open at the start (its id, inside the open card). |
nowrequired | ClockMs | — | The clock. |
style | String | Default::default() | `clean`, `classic`, or empty to follow `data-cstyle`. |
on_assign | EventHandler<(String, String)> | — | A card was dropped on an agent: (task title, agent id). |
on_restore | EventHandler<(String, String)> | — | "Add back" on a lost item: (handoff id, item id). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Through the waiting tasks, the agents (while a task is picked up) and the handed-over items |
| EnterorSpace | Opens a card or an agent's task; on a lost item: shows why, and Add back |
| Esc | Drops a picked-up card, then closes what is open |
Accessibility
- Tasks can be given to an agent without dragging: double-click a card, then click an agent to its right.
- Each column and each handoff's items are labelled lists; cards and lost items are buttons with aria-expanded.
- Status is never colour alone: a spinner, a dot or a triangle beside the words.
Responsive behaviour
- Below about 760 px the status shows as an icon only.
- Below 620 px the relay stacks into one column – an agent, its handoff, the next agent.
- Cards keep their size; the columns fade out at the bottom instead of scrolling.
Edge cases (spec)
Below about 760 px the status pill shows as an icon only; below 620 px the relay stacks into one column – an agent, its handoff column (with a blue rail), the next agent. Cards keep their size; columns fade out instead of scrolling.
Notes for AI
- Import
RelayTrailfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
RelayTrailElinoxyn_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.