AgentCursor
agent-integrationsIn-canvas agent cursor.
Why
Agents inhabiting a shared canvas need visible presence — a cursor, name, and status indicator so humans know what the agent is reading and where it's pointing. Without it, a human looking at a whiteboard or design surface sees tool calls and mutations but not the agent's focus, attention, or current task, breaking mutual awareness in collab sessions.
What
AgentCursor is a presence marker component that renders an SVG arrow icon at screen coordinates (x, y) with an optional label tag showing agent name and status (e.g. current tool). It accepts controlled x/y props (number primitives), optional color (hex string, default #a855f7), and stable class handles fai-cursor and fai-cursor__tag for styling. The component is pointer-events-neutral (read-only to humans) and designed to live inside or alongside a <Board> from @particle-academy/fancy-whiteboard.How
Import
AgentCursor from @particle-academy/agent-integrations, position it absolutely on your canvas container, and pass x, y from the agent's latest whiteboard_set_agent_cursor tool call: <AgentCursor x={100} y={200} name="Claude" status="drawing shape" color="#3b82f6" />. The MCP whiteboard bridge invokes this tool automatically as the agent moves; feed the coords straight into state.