Background agentsPro
Hand coding jobs to agents that run off-screen: describe the change, choose repo, branch and model, then follow each job through queue, setup and its steps until a diff is waiting for you to turn into a pull request and merge.
oxyn add background-agentsBackground agents
Tasks run on their own machines; you review the result.
- RunningReading the codebase4s
- Ready for review2 files changed · checks passed11s+64−12· 2 files
- MergedMerged into main11s+22−9· 1 files#412 merged
- FailedRunning the tests: 3 of 52 tests fail after the upgrade8s
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
- Hand coding jobs to agents that run off-screen, follow each through its steps to a reviewable diff, then raise and merge a pull request.
- Arc "Agent tasks" ships as background-agents because agent-tasks is the Agent / Tasks screen.
When not to use
- Sit in on a crew of agents mid-run: use Live Session instead.
- One overview for a whole fleet: use Fleet overview instead.
- The fleet overview laid out against time: use Fleet timeline instead.
Installation
Background agents 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 background-agentsUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
All
Running, ready, merged and failed tasks.
Background agents
Tasks run on their own machines; you review the result.
- RunningReading the codebase4s
- Ready for review2 files changed · checks passed11s+64−12· 2 files
- MergedMerged into main11s+22−9· 1 files#412 merged
- FailedRunning the tests: 3 of 52 tests fail after the upgrade8s
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Review
Ready for review, details open (Oxyn extra).
Background agents
Tasks run on their own machines; you review the result.
- Ready for review2 files changed · checks passed11s+64−12· 2 files
- done: Reading the codebase
- done: Planning the change
- done: Editing files
- done: Running the tests
- done: Writing the summary
- changed: src/pricing/plan_table.rs+35−6
- changed: src/pricing/yearly_toggle.rs+19−3
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Failing
The next task you start fails its tests (Oxyn extra).
Background agents
Tasks run on their own machines; you review the result.
- RunningReading the codebase4s
- Ready for review2 files changed · checks passed11s+64−12· 2 files
- MergedMerged into main11s+22−9· 1 files#412 merged
- FailedRunning the tests: 3 of 52 tests fail after the upgrade8s
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
BackgroundAgents
| Prop | Type | Default | Description |
|---|---|---|---|
nowrequired | ClockMs | — | Host clock. |
filter | usize | Default::default() | Start filter (0 all, 1 running, 2 ready, 3 merged). |
fail_next | bool | Default::default() | The next started task fails its tests (error scenario). |
open | Option<usize> | Default::default() | Open this task's details at the start (task id). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | The job field, the three pickers, Start, the tabs, then every job |
| CmdorCtrlEnter | Inside the job field: start it |
| EnterorSpace | Picker: show the choices; job title: show steps and files |
| ←or→orHomeorEnd | On the filter tabs, move the selection |
| Esc | Closes an open chip menu |
Accessibility
- Job titles toggle their detail panel and report whether it is open.
- Each state shows a glyph plus text; durations and line counts are given full spoken wording.
- Every action is read out, and the demo says plainly that the work is simulated.
From the spec
Card titles are buttons with aria-expanded and aria-controls; chip menus use menuitemradio with aria-checked; status pairs icon and word; elapsed time and diff stat have spoken labels; every action is announced including that the run and the PR are simulated. Every action returns the line the polite live region announces. The focus outline shows only for keyboard focus.
Motion & interaction
A new card slides in on top; the live step shimmers; Create pull request turns into the PR number with the GitHub mark and Merge. Chip menus open under their chips.
Timing
Everything on screen is derived from the host clock now (no timers in the block), so playback, tests and the GPUI view agree.
| Transition | Duration | Easing |
|---|---|---|
| Queue | 1400 ms | — |
| Set up | 2000 ms | — |
| Step | 1700 ms × 5 | — |
| Pull request | 1200 ms | — |
| Undo window | 6000 ms | — |
Reduced motion: shimmer, pulses and slides stop; every state keeps its words and icons.
Responsive behaviour
- Works from 320 to 760 px; pickers flow onto a new line and the shortcut hint drops under 520 px.
- Steps and files share a row from 600 px, otherwise one above the other.
Edge cases (spec)
Up to 760 px and down to 320 px; chips wrap under the field, the shortcut hint hides below 520 px; titles clamp to two lines; details are two columns from 600 px. Layout follows the block's own width (container queries), never the viewport. 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 data series and the official coloured brand and model marks.
Notes for AI
- Import
BackgroundAgentsfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
BlocksViewinoxyn_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.