Reference · status-line

StatusLine

Single-line compact view of multiple named statuses.

Anatomy

✓ built  ✓ tested  ● deploying  ○ verified

Usage

statusLine({
  items: [
    { label: 'built',     status: 'done' },
    { label: 'tested',    status: 'done' },
    { label: 'deploying', status: 'active' },
    { label: 'verified',  status: 'pending' },
  ],
})

Statuses

Same as step: pending, active, done, failed, skipped.

Options

type StatusLineOptions = {
  items: ReadonlyArray<{
    label: string
    status: 'done' | 'active' | 'pending' | 'failed' | 'skipped'
  }>
  separator?: string  // default: '  '
  theme?: PartialTheme
}

Do & don't

Do — use for top-of-output dashboards, compact CI summaries

Don't — use for detailed multi-phase progress (use step)

Out of scope

▸Labels with icons per status

▸Auto-refresh (static only)

▸Spinner animation on active items