ToolTimeline
A whole working session summarized as verbs, targets, and file stats.
Install it:
npx shadcn add @ambientui/tool-timelineLive
Four steps, two files
Behavior
- ·Summarizes to "N steps · M files changed" — the only two questions worth answering at a glance about a long run.
- ·File stats sit at the bottom and carry +/− counts, because a change to your files is the part with consequences.
- ·Additions and removals use the status pair (--positive / --destructive), never bespoke greens and reds.
- ·Open by default: a session summary the user has to discover defeats the summary.
- ·Steps land one by one, each row growing in — the record admits it was assembled over time, and a row appearing at full height would shove the list in a single frame.
- ·Every step row is a ghost button: pass onStepSelect to make it a jump — open the file, reveal the diff — and the record reads as traversable either way.
When to use
- ·After an agent run of more than a couple of steps.
- ·Wherever the user needs to know what was touched before they trust the result.
When not to
- ·For a single call, which reads better as a ToolCall.
- ·As a progress indicator during the run — it is a record, not a spinner.