roadraven-hud
Reviewed
at commit 94d2e8f
RoadRaven pane in Claude Code: live agents on roadmap nodes, batched UAT sign-off, and a backlog you can start or prioritise
0 upvotes
Log in to upvote or save- Made by
- Shuffzord
- Pinned commit
-
94d2e8f476389917ade84e5f55877c77e5923083 - What we checked
-
Adds a RoadRaven pane and status-line count that poll the RoadRaven desktop app on your machine (through its MCP server) every few seconds, showing running agents, UAT items to pass or fail, and a backlog. Buttons write your UAT decisions and notes to the roadmap, send a summary prompt to your session, or start a sub-agent on a node. Needs the RoadRaven app and its MCP server; stores agent labels per roadmap.
Review details
Static review of the source at the pinned commit; not run. Registers session.start (registers /roadraven, starts a 4 s poll via $.clock.every, backing off to 30 s after a minute offline), command.run for /roadraven, tool.call (records a one-line description of every tool call, the tool name plus the first line of command/description/pattern/url or the file name, into an in-memory atom for the pane, and for RoadRaven MCP tools links the node to the agent after the call; the call itself is passed on unchanged), agent.spawn (records name, type, model, effort), turn.complete (adds token usage), and ui.render for its Pane and, only when the spinner option is set to raven (default classic) and RoadRaven is connected, the Spinner props (word and suffix only). All roadmap access goes through $.mcp.call to the server named roadraven or plugin:roadraven:roadraven (getRoadmap, findNodes, getNode, updateNodes, updateNodeNotes, revealNode); writes only happen on the user's Send, Next or Run buttons and use expectedRevision with one retry on a stale write. Send writes statuses (pass to completed, fail to blocked), appends notes, then submits one framed prompt via $.prompt.submit (falling back to $.session.append); Run asks for confirmation, then $.agent.spawn starts one general-purpose sub-agent with a fixed brief that quotes the node title as data, with the session's own model and permission mode; Run and Next add a framed note with $.session.append. Reads $.settings.read once for prefersReducedMotion and axScreenReader only, reads HOME/USERPROFILE/LOCALAPPDATA/XDG_CONFIG_HOME to find the RoadRaven app's settings.json (theme id only) and theme JSON files, and its own bundled themes/*.json (colour tokens only, checked). $.store keeps agents (newest 50), node owners and seen UAT ids per roadmap file path. Roadmap text is stripped of control characters before drawing. The client modules raven-mark.tsx and bar.tsx only animate glyphs on the surface clock. No fetch, sockets, processes or file writes of its own. Not reviewed: the RoadRaven desktop app and the separate roadraven plugin that ships the MCP server (the README says it reaches the app on 127.0.0.1). The README describes these behaviours accurately.
- What it uses
-
- Reads your prompts: no
- Sees tool calls: yes
- Blocks or changes tool calls: no
- Reads or writes files: yes
- Runs programs on your machine: no
- Calls the model (uses tokens): no
- Sends data over the network: no
- Stores data: yes
- Shows something on screen: yes
Made this mod? Add a badge to your README
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/roadraven-hud/)