Job queuePro
The work waiting for your agents and how fast it moves – a live queue, workers running jobs as growing bars, Done and Failed, and a depth chart that shows the backlog build up under a rate limit and drain after.
oxyn add job-queue- Waiting
- 4
- Running
- 4/4
- Throughput
- 70/min
- Wait p95
- 12s
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
- The work waiting for your agents and how fast it moves: a live queue, workers running jobs as growing bars, Done and Failed, the four numbers, and a depth chart that shows the backlog build up when a rate limit pauses the workers and drain when they resume.
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
Job queue 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 job-queueUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Default
Jobs drop into the queue, glide onto free workers as growing bars and land in Done or Failed; every pass a rate limit stops the workers, the backlog climbs past the backpressure line and drains after.
- Waiting
- 4
- Running
- 4/4
- Throughput
- 70/min
- Wait p95
- 12s
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Limited
A rate limit with its countdown: running jobs paused, Waiting amber above the line, an amber stretch on the chart.
- Waiting
- 15
- Running
- 4/4
- Throughput
- 60/min
- Wait p95
- 12s
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Paused
Paused by hand: a grey pill, Resume, the workers waiting.
- Waiting
- 15
- Running
- 4/4
- Throughput
- 58/min
- Wait p95
- 12s
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
One worker
One worker: the queue grows and the rest show as a grid of dots by kind.
- Waiting
- 16
- Running
- 1/1
- Throughput
- 61/min
- Wait p95
- 12s
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Card
A job's card: how long it waited, its place, priority and attempt, with Cancel and Move to front.
- Waiting
- 15
- Running
- 4/4
- Throughput
- 60/min
- Wait p95
- 12s
- Waiting
- 4.3s
- Position
- 2 of 15
- Priority
- High
- Attempt
- 1 of 3
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Narrow
Under 600 px the flow stacks: queue, then workers (marks only), then Done and Failed side by side.
- Waiting
- 4
- Running
- 4/4
- Throughput
- 70/min
- Wait p95
- 12s
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Classic
Classic style: mixed-case labels, the numbers and the chart in inset panels.
- Waiting
- 15
- Running
- 4/4
- Throughput
- 60/min
- Wait p95
- 12s
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
JobQueue
| Prop | Type | Default | Description |
|---|---|---|---|
title | String | "Queue" | Heading. |
name | String | "agent-work" | The queue's name, muted next to the title. |
workers | usize | 4 | Workers at the start (1–8). |
at | Option<u64> | Default::default() | Freeze the demo this many ms into a pass. |
paused | bool | Default::default() | Start paused. |
open_at | Option<usize> | Default::default() | A job whose card is open at the start (its place in the queue, 0 = front). |
nowrequired | ClockMs | — | The clock. |
style | String | Default::default() | `clean`, `classic`, or empty to follow `data-cstyle`. |
on_paused_change | EventHandler<bool> | — | Pause (`true`) or resume. |
on_concurrency_change | EventHandler<usize> | — | The number of workers changed. |
on_promote | EventHandler<String> | — | Move to front (job id). |
on_cancel | EventHandler<String> | — | Cancel a waiting job (job id). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Into the jobs (the front job is the one stop), then the card's buttons |
| EnterorSpace | Opens or closes the focused job's card |
| Esc | Closes the card |
Accessibility
- Every job is a button named with its kind, how long it waited or ran, its place in line, priority and attempt.
- Pause is a toggle with aria-pressed; the stepper's buttons say what they do and the count is announced.
- The chart is an image summarised in words; rate limits, pauses and crossing the backpressure line are announced politely.
Responsive behaviour
- 756 px up to its container.
- Under 600 px the flow stacks and the four numbers wrap to two columns; under 440 px Pause and the stepper get their own row.
Edge cases (spec)
Under 600 px the flow stacks: queue, workers (marks only), Done and Failed side by side; the numbers wrap to two columns. Under 440 px Pause and the stepper take their own row.
Notes for AI
- Import
JobQueuefromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
JobQueueElinoxyn_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.