Agent Orb
The face of a voice or chat assistant. Idle breathes, listening leans out toward the sound, thinking turns inward with a light circling inside, speaking pulses with the words. Pass a live audio `level` and it follows the real sound; leave it out and it generates a believable rhythm.
Ready for AI tools one file typed props installs by name prompt included
The decision inside it
Each state moves differently, not just in a different colour
Someone glancing at it knows the state without a label, and a label is still announced to screen readers when it changes. Every amplitude glides to its new target, so changing state looks like one creature changing its mind. Off screen it stops; reduced motion draws each state still.
Installation
How you get it
Paste this into Claude Code, Cursor, Codex or any coding agent. It installs the file and uses it as it is, instead of writing a new one.
Use Layro's Agent Orb for this.
Install it: npx shadcn@latest add @layro/agent-orb
(the @layro registry is set up in components.json, with LAYRO_KEY in .env.local)
Import it from @/components/ui/agent-orb.
Do not rewrite or restyle it. Pass my data through its props
and keep its built-in states.For the full brief with every prop and the mistakes assistants usually make, use Copy prompt above. Free components install through the @layro registry with your CLI token: see the Namespaced tab.
When to use it
Use Agent Orb as the face of a voice assistant: one shape that shows idle, listening, thinking and speaking. Drive state from your audio pipeline; pass level for real input volume.
Usage
import { AgentOrb, type AgentOrbState } from "@/components/ui/agent-orb";
export function VoiceOrb({ state, level }: { state: AgentOrbState; level?: number }) {
return <AgentOrb state={state} level={level} size={180} />;
}API
“Copy prompt” above puts a full brief on your clipboard — install command, dependencies, props, and the mistakes an assistant usually makes with this component.
Props
Read from the component’s own TypeScript interface when the site is built, so this table cannot drift from the file you install.
| Prop | Type | Notes |
|---|---|---|
state | AgentOrbState | What the assistant is doing. Default `idle`. |
level | number | Audio level, 0 to 1. Generated when left out. |
size | number | Diameter of the orb, in px. Default 168. |
colorClassName | string | Main colour class, read as `color`. Default blue. |
accentClassName | string | Second colour class, read as `color`. Default sky. |
labels | Partial<Record<AgentOrbState, string>> | Words announced for each state. |
look | "soft" | "glass" | — |
Dependencies
npm packages
clsxframer-motiontailwind-mergeLayro foundations, installed alongside it
layro-themeLifetime access
Every component, and everything we ship next.
- All 132 components, source included
- Every template, and everything released after you buy
- shadcn CLI or download — React 18/19, Tailwind v4
- One payment. No subscription.
More in Creative
All Creative components
Thinking Shimmer
FreeA model's reasoning as a moving window that folds into a receipt.
Token Stream
FreeStreaming text that flows evenly instead of landing in bursts.
Tool Call Trail
FreeAn agent's tool calls drawn as a path, with a spark on the step running now.
Contour Field
FreeTopographic lines that shift slowly behind a section and part around the pointer.
Ember Field
FreeWarm sparks rising through a section, gathering and swirling around the pointer.
Image Trail
FreePhotos drop along the pointer's path and lift away a moment later.