Components · Control

Agent Inbox

Background agents finish laps while you're elsewhere. The inbox is where their results wait: runs that need a decision surface first with the reason named, running work stays visible, and finished work files itself quietly. It's the difference between agents you check on and agents that report to you.

When to use

Any product with agents that outlive the session: overnight runs, scheduled jobs, long research tasks. Skip it if every run completes while the user watches; a queue of one is ceremony.

Behavior

Four statuses: needs you, running, done, failed. Needs-review items carry the reason (low confidence, irreversible step, failure), because a red dot without a why just manufactures anxiety. Nothing auto-completes past a consent point while sitting in the queue.

Usage

tsx

import { AgentInbox } from "@/components/agent-inbox";

<AgentInbox
  items={runs}
  onOpen={(id) => router.push(`/runs/${id}`)}
/>

Install

shell

npx shadcn@latest add https://agent-pitstop.vercel.app/r/agent-inbox.json

Or copy the source from registry/agent-inbox. MIT licensed.

Agent inbox2 need you

Tap a run to open it for review.