ClaudeCodeMod

All shelves / Mods / Workflow

roadraven-hud

By Shuffzord

roadraven-hud is a Claude Code workflow mod by Shuffzord.

Draws a live pane of RoadRaven, a local desktop plan tree, with agents on each node, UAT you pass or fail, and a backlog you can start.

Draws

Install

The marketplace name is roadraven.

In Claude Code
/plugin marketplace add Shuffzord/RoadRaven
/plugin install roadraven-hud@roadraven
Open the repo

It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.

Version
0.9.0
Repo stars
9
Last change
2026-10-12

What it can reach

  • Draws in the session
  • Sees tool calls
  • Runs a command when you press
  • Calls another program on this machine

RoadRaven is a local desktop app, Windows and Linux today, and the plan is a roadmap.json on this machine. The pane opens once the app is running with a roadmap open, or any time with /roadraven. It talks only to that app on 127.0.0.1, through the RoadRaven MCP server, and to this Claude Code session. Nothing leaves the machine. Send writes the UAT statuses and notes you chose, then submits one prompt. Run asks first, then starts one general-purpose sub-agent on that node, using the session's own model, and leaves a note the session reads next turn. Next marks that node to be taken next and leaves the same kind of note. The status line reads like RR 2 active, 1 UAT. It follows the app theme. The README's new-install row is /plugin install roadraven@roadraven, and it says the HUD is a dependency, so that install brings this one too.

The install name is roadraven-hud. The marketplace name is roadraven. The same marketplace also lists roadraven. This one installs on its own. The marketplace source is ./plugins/roadraven-hud. RoadRaven keeps the plan and the work in one local tree, with no cloud and no accounts. The pane is why this page files it under workflow. roadmap-jasonwarrenuk draws a /ready pane of the tasks ready in a dependency-graph roadmap and claims the one you pick. Skills in the same install update the graph. Nothing else on the shelf draws a RoadRaven pane in the session. The app is already running on this machine. The README says the HUD starts no processes of its own. The prompt Send submits, and the note after Run or Next, are what the session reads.

Demo

The RoadRaven pane: five active nodes with no agent, six UAT rows with Pass and Fail, a note that two decisions were sent, and a backlog row with Run and Next.
From the author's repo.

What it hooks into

  • session.startWhen a session starts
  • command.runWhen you run its slash command/roadraven
  • tool.callAround a tool call, where it can hold one
  • agent.spawnWhen a subagent starts
  • turn.completeWhen a turn ends
  • ui.renderDraws into the sessionPane

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Slash commands 1

  • /roadravenShow RoadRaven active work, UAT and backlog in a pane

Files

The author's README and source, 4 files. They load when you open them.

Facts

Author
Shuffzord
Category
Workflow
Marketplace
roadraven
Repo
Shuffzord/RoadRaven
Folder
plugins/roadraven-hud
Version
0.9.0
Repo stars
9
Last change
2026-10-12
Language
TypeScript
Files
20

Same repo on other shelves

MCP servers

  1. 6420RoadRavenio.github.Shuffzord/roadravenCreate and update roadmap tree nodes and statuses in the RoadRaven desktop app (must be running).10

Other mods in Workflow

bettercallgptinsta-fusionPuts this session on a voice call you talk on while Claude codes, and sends microphone audio and call text to Azure or OpenAI on your own key.allowlist-coachice-lfernandesCounts permission dialogs you answer and, after repeated approvals, offers that rule for the allow list, asking you before it writes.test-hudice-lfernandesDraws each test run on the status line, passing over total with a sparkline of failures, and a pane of the tests that failed.run-lot-panepierrebelinFor cctoolkit, which builds a feature batch by batch, draws a live pane of the batch or the plan, with agents, tools, and tokens.html-shelfronanworksDraws paths in a reply as links that open in the default app, and code blocks as cards you can copy or place in the prompt.actual-cliactual-softwareFor Actual AI, which keeps agents on a team's architecture decisions, draws a row of how many ADRs reached context and adds a file's rules beside each read.autodev-coredjnsty23Holds a commandFor Claude Auto-Dev, an autonomous workflow from brainstorm to ship, pins a status line under the prompt with what its hooks did and the sprint's pass states.kgai-modkgaidevDraws a status line when a decision is recorded, and Record and Skip in confirm mode, for kgai, the team's shared memory of why the code changed.glanceflowAntreas-StrbHolds a commandDraws a checklist above the prompt with the plan, the step Claude is on, how far along it is, and when Claude needs you.batonashishsk93Draws a band above the prompt of this session, the other sessions, and the tasks passed between them.todosbengousDraws the repository's TODOs in a scrolling band above the prompt, newest first, including findings an agent recorded.zcode-executorKyoMioFor zcode-executor, which hands Claude's tasks to the local ZCode agent, draws a live pane of this project's ZCode sessions and the requests waiting on you.
All 396 in Workflow