# AI Agent Status Badge

Header of an agent run that moves from working to waiting-approval and opens the approval on click.

- id: `ai-agent-status-badge`
- Page: https://agentic-ui-kit.com/components/ai-agent-status-badge
- Live preview: https://agentic-ui-kit.com/live/component/ai-agent-status-badge

## Install

```bash
agentic-ui add ai-agent-status-badge
npx shadcn@4.17.0 add @agentic-ui/ai-agent-status-badge
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york)
- **Capabilities:** status-indicator, lifecycle-states, live-announcement, detail-tooltip, actionable-state, compact-dot, unknown-status-fallback, reduced-motion, keyboard-navigation
- **Intents:** orchestrate-agents, track-status, monitor-live
- **Suits domains:** ai-agents, ai-workspace, devtools, operations, project-management
- **Interaction:** tooltip, click-to-act, keyboard-navigation, live-announcement
- **Screen role:** overview
- **Density:** compact
- **Dark mode:** yes
- **Use it for:** header of an agent run that moves from working to waiting-approval and opens the approval on click, roster of parallel agents with status and time in status, workflow node or table row with a compact dot indicator, blocked agent showing the reason in a tooltip and to screen readers
- **Avoid when:** run states of an individual tool with input/output (use ai-tool-call-card), generic states not tied to an agent lifecycle, the full timeline of steps is needed (use ai-agent-run-trace)
- **Preserve when adapting:** five-state-contract, icon-plus-label-signal, transition-only-announcements, unknown-status-fallback
- **Replace when adapting:** domain-copy, status-labels, token-tints
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 8.9/10
- **Quality breakdown:** visual 8/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** badge, tooltip
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Registry dependencies:** lib-primitives