Agent Cursors
An overlay of cursors that glide to where each agent is working, with its name, colour and what it is doing. Labels can be buttons. Screen readers get a short list of who is there and what they are doing.
The decision inside it
A list for screen readers, not coordinates
Cursor positions mean nothing read aloud, so assistive tech hears each agent's name and action once, and the moving cursors are hidden from it.
When to use it
Use Agent Cursors when agents edit a shared document, canvas or table and people should see where each one is working. Put it inside the positioned element the agents work in and pass pixel positions. For a log of what agents did, use Agent Timeline.
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 Cursors for this.
Install it: npx shadcn@latest add @layro/agent-cursors
(the @layro registry is set up in components.json, with LAYRO_KEY in .env.local)
Import it from @/components/ui/agent-cursors.
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. Pro components install through the @layro registry with your CLI token: see the Namespaced tab.
Usage
"use client";
import * as React from "react";
import { AgentCursors, type AgentCursor } from "@/components/ui/agent-cursors";
export function AgentPresence({ cursors, children }: { cursors: AgentCursor[]; children: React.ReactNode }) {
const box = React.useRef<HTMLDivElement>(null);
return (
<div ref={box} className="relative">
{children}
<AgentCursors containerRef={box} cursors={cursors} />
</div>
);
}API reference
“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 |
|---|---|---|
cursorsrequired | AgentCursor[] | — |
containerRef | React.RefObject<HTMLElement | null> | The element they work in, used to keep cursors inside it. Optional: the overlay fills its positioned parent. |
showLabels | boolean | Name tags beside the tiles. Default true. |
smoothing | number | 0 snaps, 1 drifts slowly. Default 0.5. |
onCursorClick | (id: string) => void | Makes each label a button; called with the agent's id. |
Dependencies
npm packages
clsxframer-motionlucide-reacttailwind-mergeLayro foundations, installed alongside it
layro-themeStates
All of them are drawn by the component. None is left for you to design.
- Typing
- Selecting
- Idle
- Clickable labels
- Reduced motion
Accessibility
- Keyboard reachable throughout, in visual order
- Focus trapped in overlays, Escape closes them
- Focus returns to whatever opened it
- Live regions announce what changed, not that something did
- Honours prefers-reduced-motion
Responsive behavior
- Sizes to its container, not the viewport
- Usable from 320px up
- Pointer-based interaction, so trackpad and touch both work
- No hover-only affordances
Lifetime access
Every component, and everything we ship next.
- All 232 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 AI AgentAll AI Agent components
Agent Workspace
A whole agent screen: task in, plan, tool calls, approval and a summary out.
Agent Run Status
The top of a run: state, current step, a live clock, and Pause and Stop.
Task Plan
The agent's plan as steps that tick off live, with the risky one flagged ahead.
Tool Call
One tool the agent used: what it sent, what came back, how long it took.
Approval Request
The agent stops and asks first, showing the exact thing it wants to do.
Agent Timeline
Everything a run did, in order: follow it live, or inspect it step by step.