Skip to content
Back

Activity pillPro

A compact pill for an app bar or side rail counting background agent work – how much is running, how much waits on you – that opens to each task's ring, current step, Pause / Resume and Open.

oxyn add activity-pill
Acme / Agents
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

  • A quiet live status of background agent tasks for an app bar or sidebar: one pill with the counts that matter, opening to the tasks with their progress, step, Pause / Resume and Open.

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

Activity pill 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 activity-pill

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

Open

Open over an app bar: rings fill as tasks move through their steps; Pause, Resume and Open work, and the pill's counts follow.

Acme / Agents
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

Closed

Closed: just the quiet pill – only the groups that aren't zero.

Acme / Agents
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

Paused

Everything that was running paused: grey frozen rings, Resume buttons, the pill down to what needs you.

Acme / Agents
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

Done

All finished: full rings with a check, the pill says so.

Acme / Agents
Weekly report: done
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

Sidebar

In a sidebar, opening to the right.

Workspace
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

Words

Your own words for the heading.

Acme / Agents
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

Classic

Classic style: a squarer pill, a header band and footer band in the popover.

Acme / Agents
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

ActivityPill

PropTypeDefaultDescription
tasksOption<Vec<RnTask>>Default::default()The tasks (the demo's when `None`).
default_openboolDefault::default()Popover open from the start.
placementString"below-end"Where the popover opens: `below-end` (header, the default), `below-start`, or `right` (a sidebar).
step_msu642600One step per this many ms while running (0 freezes).
titleString"Background tasks"Popover heading.
open_allbooltrueShow the "Open tasks" footer.
nowrequiredClockMs—The clock.
styleStringDefault::default()`clean`, `classic`, or empty to follow `data-cstyle`.
on_openEventHandler<String>—A task opened (id).
on_pauseEventHandler<(String, bool)>—A task paused (`true`) or resumed (`false`).
on_open_allEventHandler<()>—"Open tasks" pressed.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
EnterorSpaceOpens or closes the list from the pill
TabEach task, its Pause / Resume or Open, then Open tasks
EscapeCloses the list

Accessibility

  • The pill is a popup button (aria-expanded) whose name carries the counts; the list is a labelled dialog.
  • Each row's main button names the task and its step; Pause and Resume are named per task.
  • Finishing tasks are read out politely; reduced motion stops the ring sweep.

Responsive behaviour

  • The pill is inline and fits any header; the 284 px list opens below and aligned to the pill's end, or to the right in a sidebar.
Edge cases (spec)

The pill shrinks to its counts; the popover stays inside its container width (max-width 100 % of the viewport less 16 px).

Notes for AI

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