Skip to content
Back

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-agents

Background agents

Tasks run on their own machines; you review the result.

⌘ Enter
  • northwind/webmainClaude Sonnet 4.5

    RunningReading the codebase4s
  • northwind/apimainGPT-5 Codex

    Ready for review2 files changed · checks passed11s+64−12· 2 files
  • northwind/webmainClaude Sonnet 4.5

    MergedMerged into main11s+22−9· 1 files
    #412 merged
  • northwind/mobilemainGemini 2.5 Pro

    FailedRunning the tests: 3 of 52 tests fail after the upgrade8s
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

  • 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

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.

Terminal
oxyn add background-agents

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

All

Running, ready, merged and failed tasks.

Background agents

Tasks run on their own machines; you review the result.

⌘ Enter
  • northwind/webmainClaude Sonnet 4.5

    RunningReading the codebase4s
  • northwind/apimainGPT-5 Codex

    Ready for review2 files changed · checks passed11s+64−12· 2 files
  • northwind/webmainClaude Sonnet 4.5

    MergedMerged into main11s+22−9· 1 files
    #412 merged
  • northwind/mobilemainGemini 2.5 Pro

    FailedRunning the tests: 3 of 52 tests fail after the upgrade8s
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

Review

Ready for review, details open (Oxyn extra).

Background agents

Tasks run on their own machines; you review the result.

⌘ Enter
  • northwind/apimainGPT-5 Codex

    Ready for review2 files changed · checks passed11s+64−12· 2 files
    1. done: Reading the codebase
    2. done: Planning the change
    3. done: Editing files
    4. done: Running the tests
    5. done: Writing the summary
    • changed: src/pricing/plan_table.rs+35−6
    • changed: src/pricing/yearly_toggle.rs+19−3
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

Failing

The next task you start fails its tests (Oxyn extra).

Background agents

Tasks run on their own machines; you review the result.

⌘ Enter
  • northwind/webmainClaude Sonnet 4.5

    RunningReading the codebase4s
  • northwind/apimainGPT-5 Codex

    Ready for review2 files changed · checks passed11s+64−12· 2 files
  • northwind/webmainClaude Sonnet 4.5

    MergedMerged into main11s+22−9· 1 files
    #412 merged
  • northwind/mobilemainGemini 2.5 Pro

    FailedRunning the tests: 3 of 52 tests fail after the upgrade8s
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

BackgroundAgents

PropTypeDefaultDescription
nowrequiredClockMs—Host clock.
filterusizeDefault::default()Start filter (0 all, 1 running, 2 ready, 3 merged).
fail_nextboolDefault::default()The next started task fails its tests (error scenario).
openOption<usize>Default::default()Open this task's details at the start (task id).

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabThe job field, the three pickers, Start, the tabs, then every job
CmdorCtrlEnterInside the job field: start it
EnterorSpacePicker: show the choices; job title: show steps and files
←or→orHomeorEndOn the filter tabs, move the selection
EscCloses 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.

TransitionDurationEasing
Queue1400 ms—
Set up2000 ms—
Step1700 ms × 5—
Pull request1200 ms—
Undo window6000 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 BackgroundAgents from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: BlocksView 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