Skip to content
GetUrUI

Agent Timeline

Pro
.md

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

PropTypeDefaultDescription
steps*AgentStep[]—{ id, kind, title, status, detail?, startedAt?, endedAt? }. Update status to drive the animation.
titlestring"Agent activity"Heading above the timeline.
defaultExpandedstring[]—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.

Related