Live timeline of an agent's steps — thinking, searching, reading, editing — with morphing status icons, ticking timers, expandable details and a shimmer on the active step.
aiagenttimelinestepsprogressreasoning
When to use it
Use it for
- Showing what an AI agent is doing while it works: planning, searching, reading files, editing and running commands, with a live timer on the active step.
- A record of a finished run that people can open step by step, with files, queries, diffs or logs in each step's detail.
What it needs from your app
- Your agent's events mapped to AgentStep objects: one step per action, status moving from pending to active to done (or error), and startedAt / endedAt in epoch milliseconds for the timers.
- A new steps array each time an event arrives. The component has no connection to your agent or model; it renders the state you pass.
Limits
- Step kinds are a fixed set (thinking, searching, reading, editing, running, done); map other actions to the closest kind and describe them in title.
- Every step you pass is rendered, so summarise or trim very long runs.
Pairs with
- Tool Permission Card: Pause the run and ask a person to approve a tool call before the next step starts.
- Token Stream: Stream the agent's final answer under the timeline.
Installation
Pro installs use your private registry token. Add the @geturui-pro registry once — setup guide. The command works after you get Pro.
$npx shadcn@latest add @geturui-pro/agent-activity
Also installs: Text Animation
Usage
usage.tsx
1import { AgentActivity } from "@/components/ai/agent-activity";
2
3<AgentActivity
4 title="Fix the failing build"
5 steps={[
6 { id: "1", kind: "thinking", title: "Planning", status: "done", startedAt: t0, endedAt: t1 },
7 { id: "2", kind: "reading", title: "Reading 4 files", status: "active", startedAt: t1, detail: "next.config.ts · package.json" },
8 { id: "3", kind: "editing", title: "Editing next.config.ts", status: "pending" },
9 ]}
10/>
Props
| Prop | Type | Default | Description |
|---|---|---|---|
steps* | AgentStep[] | — | { id, kind, title, status, detail?, startedAt?, endedAt? }. Update status to drive the animation. |
title | string | "Agent activity" | Heading above the timeline. |
defaultExpanded | string[] | — | Step ids expanded on first render. |
Accessibility
- Each step is a button with aria-expanded when it has details; status is announced as a word.
- Overall progress is a progressbar; the summary line is a polite live region.
- With reduced motion, icons swap without rotation and the spinner ring is hidden.