BackgroundStatus

Markdown

A small persistent indicator for runs still going while the person is elsewhere.

Good to know

Zero counts are hidden and an idle status reads "Nothing running". An unknown count still shows, as "?".

Use it for: A small indicator for runs still going elsewhere.
Not for: The list of runs itself. Try RunBoard.

Loading example…

Installation

npm install @stackunseen/ui

import { BackgroundStatus } from '@stackunseen/ui/conversation-flow';

Styles: @stackunseen/ui/styles.css and @stackunseen/ui/conversation-flow.css

Usage and props

Import this component from @stackunseen/ui/conversation-flow. Load @stackunseen/ui/styles.css first, then @stackunseen/ui/conversation-flow.css.

Your app updates the counts; the indicator never polls. If updates stop arriving, it says so.

Supported inputs

This is the public signature used by this example. Open Code to see how the values and callbacks fit together.

running · waiting · lastHeartbeatAt? · staleAfterMs? · now? · onOpen?

How state and callbacks work

All props

Loading…

For your coding agent

Give the agent this page instead of a screenshot. The prompt wraps the page with the install and import lines and the rule that your server, not a click, completes an action.

Contract: running · waiting · lastHeartbeatAt? · staleAfterMs? · now? · onOpen?
Keeps honest: Your app updates the counts; the indicator never polls. If updates stop arriving, it says so.
MCP: read_component "BackgroundStatus" on the docs endpoint

Open the Markdown file

Keyboard and customization

Keyboard

Tab reaches controls; Enter or Space activates buttons. Accordions use arrow keys, Home and End. Select menus support arrows and typeahead; Escape closes menus and dialogs and restores focus.

Customization

Change shared colors, spacing, corners and icons with the theme. Use the component's supported props to adapt its content and layout. Customization guide and Theme Studio

BackgroundStatus

Good to know