Arc
ComponentsBlocksDocsPricingTry the demo
Introduction
Installation
Theming
Motion
AI and MCP
Changelog
Metrics dashboard
KPI drilldownNew
Metric explorer
Revenue explorer
MRR waterfall
Cohort retention
Usage forecast
Journey flow
Connected scatterNew
Market terminalNew
Budget varianceNew
Small multiplesNew
Line replayNew
AI chatNew
AI composer
Agent runNew
SidebarPro4
Page header
Command palette
Notification center
Empty states
Login and sign up5
OTP input
Multi-step formPro
Settings page
Security settings
Billing overview
Usage billingNew
Team members
Invite peopleNew
Team directory
Roles and permissions
API keys
Webhooks
Integrations
Plan comparison
Pricing calculatorNewPro
Usage pricingPro
Cart drawerNewPro
Checkout summaryNewPro
Invoice studio
Wallet card
Product listingNew
Product detailNew
Inbox triage
Support conversation
Support widget
File upload
Media playerPro
Week calendarNew
Availability picker
Project board
Release readiness
Hero sectionNew
Hero signupNewPro
Scroll storyNewPro
Spotlight gridNewPro
Feature bentoNewPro
Comparison tableNew
Logo marquee
Studio perspectivesPro
Stats bandNew
Changelog feed
FAQ sectionNew
Contact sectionNew
Team showcasePro
Blog gridNew
Site headerNew
Site footerNew
CTA sectionNew
Newsletter signupNew
Revenue globe
Customer galaxy
Semantic zoom
Layout morph
What’s new80 new
BlocksAgent run

Agent runPro

A live AI agent run: steps stream in, tool calls expand, a diff waits for approval, and it all folds into a result.

Live block · sample data

When to use

  • Showing an AI agent working through a task with a human approval step, such as a coding agent.
  • Runs where each step should stream into a timeline and a diff waits for approval before writing.

When not to use

  • Use text-stream for plain streamed text.
  • Use ai-composer for the prompt input.
  • Use timeline for a static list of events.

Installation

Pro source and install commands unlock with a Pro plan.

Usage

Use this to show an AI agent working on a task with approval steps. Replace the scripted run in agent-run-data.ts with events from your agent runtime.

example.tsx
1import { AgentRun } from "@/registry/blocks/agent-run/agent-run";2 3export default function AgentTaskPage() {4  return (5    <main>6      <AgentRun />7    </main>8  );9}
Built fromAnimated counterMotion

API reference

AgentRun

A live view of an AI agent working through a task. Steps stream into a timeline and expand in place, a diff waits for approval before any write, and the run folds into a result with a pull request action. Takes no props; the request, steps, timing, approval gate and result are a scripted run in agent-run-data.ts, and opening the pull request is simulated.

No props.

Accessibility

  • Each step header is a disclosure button with aria-expanded and aria-controls pointing at a labelled details region.
  • A polite live region announces the current step, the approval wait, pauses and the final result.
  • After Approve, Reject or Retry, focus moves back to the gated step's header; Restart focuses the pause button.

Motion

  • The run starts the first time the block scrolls into view, and the clock holds while the tab is hidden.
  • Steps stream in with heights that follow content on a smooth spring, and the active step title shimmers.
  • Reduced motion makes height and panel changes instant.

Responsive behavior

  • Below a 480px viewport the frame padding and prompt size shrink and hit text hides.
  • Step details expand in place with a ResizeObserver tracking their height.

Performance

  • The run clock uses one setInterval that holds while the tab is hidden.
  • Steps are not virtualized; very long runs should collapse finished steps.

Notes for AI

Give your coding assistant the Markdown reference instead of screenshots.

  • Use to show an AI agent working on a task with a human approval step, such as a coding agent or workflow runner.
  • Replace STEPS, TIMING, GATE, REQUEST and RESULT in agent-run-data.ts with events streamed from your agent runtime.
  • Wire Approve, Reject and Open pull request to real actions; nothing is executed in the preview.
/components/blocks/agent-run/markdown

The full library index for assistants is at /llms.txt.

Related

AI composerProBlockA focused assistant thread where messages lift out of the composer and replies stream in.Code blockComponentPresent code with legible hierarchy and copy access.TimelineComponentFollow what happened, newest first, grouped by day.Animated counterComponentGive changing totals a clear sense of movement.
PreviousLayout morphNextWeek calendar
Arc · 75 block pagesllms.txt

On this page

  • Preview
  • When to use
  • When not to use
  • Installation
  • Usage
  • API reference
  • Accessibility
  • Motion
  • Responsive behavior
  • Performance
  • Notes for AI
  • Related
View as Markdown
Olivia Bennettnorthwind/checkout

Customers are being charged twice when the payment gateway times out. Find the cause in the retry logic, fix it, and make sure the payment tests pass.

StartingTime0.0s000123456789 tokens