# Shadcn Run Status

> Run status markers with a live step

- Type: example, free and open source (MIT)
- Component: [Marker](https://web.dev.reui.io/components/marker.md)
- Page: https://web.dev.reui.io/components/marker/c-marker-3
- Docs (Base UI): https://ui.shadcn.com/docs/components/base/marker.md
- Docs (Radix UI): https://ui.shadcn.com/docs/components/radix/marker.md
- MCP: `get_example("c-marker-3")`
- Registry item: https://web.dev.reui.io/r/styles/base-nova/c-marker-3.json
- Uses: Badge, Card, Marker, Spinner

## Best for

A titled run card mixing done, failed and in progress rows, with a failed badge and a spinner on the live step

## Agent notes

- The 5 rows are written out by hand; render them from your run state and keep `role` status on the live row
- `Spinner` brings its own fixed size class, so it takes `size-full` to fill `MarkerIcon` at each style's size

## When not to use

- A summary of changed files with a kind badge and line counts per row: use [Changed Files](https://web.dev.reui.io/components/marker/c-marker-5.md) (`get_example("c-marker-5")`)
- Run steps that open to their output or nest steps of their own: use [Trace](https://web.dev.reui.io/components/trace.md) (`get_component("trace")`)

## Install

```bash
npx shadcn@latest add @reui/c-marker-3
```

## About Shadcn Marker

### When to use

- Agent run logs and tool call lists, one short line of status text per step
- Labeled dividers that split a transcript or run log into named phases
- Ruled summaries such as changed files, and rows that open a link or run an action

### When not to use

- A plain horizontal or vertical rule between content sections or menu items: use [Separator](https://web.dev.reui.io/components/separator.md) (`get_component("separator")`)
- A complete run console with approval steps, log views or an outcome report: use the [Agent Activity blocks](https://web.dev.reui.io/blocks/ai-agents/agent-activity.md)
- Dated events or milestones joined by indicator dots and a connecting line: use [Timeline](https://web.dev.reui.io/components/timeline.md) (`get_component("timeline")`)

### Agent notes

- Make a row a link or button with `render` on the base twin and `asChild` on the radix twin
- `MarkerIcon` is `aria-hidden` with everything inside it, so the `MarkerContent` text alone must say what the row means
- An svg in `MarkerIcon` takes each style's icon size only while it carries no size class of its own

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.