Command Palette

Search for a command to run...

AI Agent Status

Display current agent handling a request with status indicators, animated pulse for active states, and handoff visualization for multi-agent workflows.

Open in v0Open in
Planner
Idle
Researcher
Thinking
Coder
Acting
Reviewer
Waiting
Summarizer
Done
Router
Handing offSpecialist

Research Agent

Thinking

Analyzing search results and extracting relevant information...

Code Agent

Acting

Writing implementation for auth middleware

Overview

A compound component for displaying the current status of an AI agent in multi-agent workflows. Supports two variants: badge (compact) and card (detailed). Shows animated pulse indicators when agents are active and visualizes handoff transitions between agents.

Installation

bunx shadcn@latest add @elements/agent-status

Usage

import {
  AgentStatus,
  AgentStatusActions,
} from "@/components/elements/ai-elements/multi-agent/agent-status";

export function AgentStatusExample() {
  return (
    <AgentStatus
      agent={{
        name: "Research Agent",
        description: "Searches and analyzes information",
      }}
      status="thinking"
      variant="card"
    >
      <AgentStatusActions>
        <button>Cancel</button>
      </AgentStatusActions>
    </AgentStatus>
  );
}

Props

AgentStatus

PropTypeDefaultDescription
agentAgentInfo-Agent information (name, icon, description)
statusAgentStatus-Current agent status
handoffTostring-Name of agent being handed off to
variant"badge" | "card""badge"Display variant

AgentStatus

type AgentStatus = "idle" | "thinking" | "acting" | "waiting" | "done" | "handoff";

AgentInfo

interface AgentInfo {
  name: string;
  icon?: React.ReactNode;
  description?: string;
}

Features

  • Two display variants: badge (compact) and card (detailed)
  • Animated pulse indicator for active states (thinking, acting)
  • Visual handoff indicator when transferring to another agent
  • Color-coded status badges with icons
  • Support for custom agent icons