{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "fayazara-robot-heads--show-agent-status-in-react-ui",
 "repo": "fayazara/robot-heads",
 "repo_url": "https://github.com/fayazara/robot-heads",
 "repo_slug": "fayazara-robot-heads",
 "title": "Show a live agent status in a React app",
 "page_title": "How to show a live agent status in a React app with Robot Heads",
 "summary": "Render a robot head that changes face and motion as the agent moves between states.",
 "who": "A front-end developer building a chat or agent dashboard who needs users to see whether the agent is idle, thinking, searching, or speaking.",
 "problem": "Plain text status labels are easy to miss, and building custom animated feedback for each agent state takes time.",
 "outcome": "A React component that displays a 3D robot head whose screen, motion, and antenna light match the agent's current state.",
 "steps": [
  "Run `npm install robot-heads` in your React project.",
  "Import RobotHead from 'Robot Heads' in the component that shows agent status.",
  "Map your agent's status values to the nine states in the README: idle, thinking, searching, listening, speaking, working, happy, error, sleeping.",
  "Pass the current state to RobotHead as shown in the README Quick start, and set a size that fits your layout.",
  "Run your app and change the agent status to confirm each state renders."
 ],
 "agent_prompt": "In the React project at <project path>, run `npm install robot-heads` and render a RobotHead whose state follows the agent's status, mapping each status to one of the nine README states. Expected output: a component file that type-checks against React 18 or newer. Verify the prop names against the installed package types before finishing, because the README props block is not fully legible.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "The props section of the README did not come through cleanly, so confirm exact prop names in the installed package before wiring the state.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "typescript",
 "requirements": [
  "A React project on React 18 or newer, since React is a peer dependency",
  "Node.js with npm, or pnpm if you plan to work on the library source",
  "A way to map your agent's status values to the nine states the library supports"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/fayazara-robot-heads/show-agent-status-in-react-ui/",
 "md": "https://dedupedai.com/use-cases/fayazara-robot-heads/show-agent-status-in-react-ui/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/fayazara-robot-heads--show-agent-status-in-react-ui.json",
 "api_version": "v1"
}