# Agent Trace

> Waterfall timeline for AI agent runs with a replay scrubber: drag the playhead and spans fill, statuses flip from queued to running to done, token counts tick up. Nested sub-agents, retries, errors. No chart library, keyboard-accessible, theme tokens.

- Author: [NIMA MZ](https://21st.dev/@n1m4mz)
- License: mit
- Tags: Timeline, Animation, AI Chat, Interactive
- npm dependencies: lucide-react
- Live preview: https://21st.dev/@n1m4mz/components/agent-trace

## Install

```bash
npx shadcn@latest add "https://21st.dev/r/n1m4mz/agent-trace?api_key=$API_KEY_21ST"
```

Requires a 21st API key (generate one at https://21st.dev/mcp) passed as `API_KEY_21ST`. Free accounts get a limited number of installs per day; unlimited on a paid plan — see https://21st.dev/pricing.

Full component directory: https://21st.dev/llms.txt · More like this: https://21st.dev/community/components/s/timeline.md