When to use
- An assistant's presence needs a different character than the free orb: Ring frames an avatar or icon, Aurora reads calm and atmospheric, Dots reads technical.
- Voice and agent UIs that already use Agent Orb and want a second look without new state wiring.
When not to use
- Inline text status (a 16px orb next to a label): the free orb reads best that small. Dots needs at least 32px to show its lattice.
Installation
pnpm dlx shadcn add @eased-pro/orb-variantsnpx shadcn add @eased-pro/orb-variantsyarn dlx shadcn add @eased-pro/orb-variantsbunx --bun shadcn add @eased-pro/orb-variantsNeeds the @eased-pro registry and your Pro token in components.json. Create a token and copy the setup from your account .
Install the dependencies
pnpm add motionnpm install motionyarn add motionbun add motionAdd the Eased pieces it builds on
Copy each item’s files the same way, or install them with the CLI:
Add the files
- components/eased/orb-variants/orb-variants.tsx
Source is included with Eased Pro. Members download the files with the CLI command above, or through the MCP server.
Keep the folder layout
The files import each other by relative path (
../lib/motion), so keep each one at the path shown, undercomponents/eased/.
Usage
import { AgentOrb } from "@/components/eased/agent-orb/agent-orb";import { RingOrb } from "@/components/eased/orb-variants/orb-variants";import { useTokenRate } from "@/components/eased/_primitives/thinking-core/thinking-core";const { rate } = useTokenRate(message.text);<AgentOrb variant={RingOrb} state="speaking" rate={rate} size={72} />API reference
RingOrb, AuroraOrb, DotsOrb
Components of type OrbVariant, passed as Agent Orb's variant. They take { size, state, phase, energy, reduced } from the orb; you never render them directly. ORB_VARIANTS maps ring, aurora and dots to them for pickers.
Re-theme with --eased-orb-a, --eased-orb-b, --eased-orb-c and --eased-orb-deep on .eased-orb[data-state="…"], exactly as for the free orb.
Accessibility
- The orb owns the role (
img) and the name; variants arearia-hiddenpaint.
Motion
Ring: a conic band turns at 70°/s while a brighter comet laps it at −150°/s, and the band thickens from 8% to 15% of the diameter with energy. Aurora: four tall curtains sway and shear on their own pairs of frequencies, so the light folds rather than spins; energy widens the sway. Dots: a ripple travels outward through a hex lattice, swelling each dot as it passes, with radii written straight to the SVG from the clock (no re-renders). All three breathe 1 → 1.05 with energy, follow the orb's speed (0.4× idle to 2× speaking), pause off-screen and draw a still frame under reduced motion.
Notes for AI
Pick a variant by character, then pass it as variant; feed rate from useTokenRate and level from an AnalyserNode exactly as for the free orb.
Do not render a variant without Agent Orb, and do not animate it yourself: the orb's clock already eases speed and energy.
Related components
- AI Agent Voice Orb: the free orb and the clock these run on.
- AI Agent Steps Timeline
- AI Thinking Indicator