Repository navigation
Releases: Shuffzord/RoadRaven
Release list
v0.9.0
RoadRaven v0.9.0
Installs and updates that just work: the Setup Wizard installs the Claude Code plugin, the app can update it for you, and in-app updates work on Linux.
Added
- The Setup Wizard installs the Claude Code plugin: the tools, the
orchestrateandwork-nodeskills and the terminal pane, not just the MCP server. Ifclaudecan't be found or the install fails, the wizard sets up the MCP server as before and shows the commands to run. - Install and update the plugin from the app. When the plugin is missing or out of date, RoadRaven offers a dialog with one button that runs the install or update and shows each step.
- ↗ Show in app on every row of the RoadRaven pane selects that item in RoadRaven, centres it and opens its notes. Agents can do the same with the new
revealNodetool.
Fixed
- Updates work on Linux. Every update check failed with "unable to get local issuer certificate"; the app now uses the system's certificates. A failed check is shown in Preferences.
- Dropdowns open on Linux. The side panel's Status and Type menus and the Event Log filters didn't open on Linux; they are now in-app menus. With a dropdown focused, Enter, Space and the arrow keys open it instead of editing the selected node.
~/.claude.jsonstays private. Earlier wizard versions left it readable by other users (0644) and replaced a symlinked config with a plain file. If you ran the wizard on Linux or macOS before, runchmod 600 ~/.claude.jsononce.- No more "RoadRaven is not running" after a restart. A closing app could delete the file the next one had just written to tell agents where to connect.
- Plugin install on Windows: a timed-out step stops the whole
claudeprocess, aclaudein a folder with&,^or%isn't run, and the commands to copy come one per line so they work in the command prompt. - The RoadRaven pane: a note on every UAT item you mark, Pass as well as Fail; re-tested items notify again; failed items wait for a fix; no stuck pane, Send or Run after a reload; agent labels survive switching files; follow-app theme works on Windows and macOS.
Changed
- Smaller MCP replies: compact JSON,
findNodesreturns matches without their subtrees, andgetRoadmap({ omitNotes: true })also leaves out timestamps, so agents stay under Claude Code's result limit on big roadmaps.
Install
Desktop app:
# Windows x64 (PowerShell)
irm https://raw.githubusercontent.com/Shuffzord/RoadRaven/master/install.ps1 | iex
# Linux x86_64
curl -fsSL https://raw.githubusercontent.com/Shuffzord/RoadRaven/master/install.sh | sh
Then open the Setup Wizard and choose Claude Code: it installs the plugin for you. To install it by hand (Node.js >= 24):
/plugin marketplace add Shuffzord/RoadRaven
/plugin install roadraven@roadraven
Already on the plugin? After updating the app, RoadRaven offers Update now. Or run these, then restart Claude Code:
/plugin marketplace update roadraven
/plugin update roadraven@roadraven
/plugin install roadraven-hud@roadraven
Any other MCP host:
claude mcp add -s user roadraven -- npx -y @roadraven/mcp@0.9.0
On Windows, installed apps from 0.8.5 on offer this update in-app. On Linux, 0.8.x can't check for updates (the bug fixed above), so install 0.9.0 once with the one-liner; later updates work in-app. Every release ships SHA256SUMS.
Full changelog: CHANGELOG.md · PRs: #52, #53, #54
v0.8.9
RoadRaven v0.8.9
A hotfix for 0.8.8's Claude Code plugin update path and the RoadRaven HUD on large roadmaps.
Fixed
- The app tells you when the Claude Code plugin is a patch version behind. The version-mismatch toast compared only major.minor, so after updating the app from 0.8.7 to 0.8.8 plugin users saw nothing and never got the RoadRaven HUD. Any version difference now shows the toast with the commands to update the plugin and install the HUD.
- The RoadRaven HUD works on large roadmaps. A roadmap with long notes outgrew Claude Code's MCP result limit and the pane showed "JSON Parse error". The pane now polls without notes (
getRoadmap({ omitNotes: true })), fetches UAT notes only when UAT items change, and says plainly if a roadmap is still too large. - Event-server and agent logs reach
roadraven.log(connection, version and agent-request lines were dropped).
Install
Desktop app:
# Windows x64 (PowerShell)
irm https://raw.githubusercontent.com/Shuffzord/RoadRaven/master/install.ps1 | iex
# Linux x86_64
curl -fsSL https://raw.githubusercontent.com/Shuffzord/RoadRaven/master/install.sh | sh
Claude Code plugin (brings the HUD as a dependency; Node.js >= 24):
/plugin marketplace add Shuffzord/RoadRaven
/plugin install roadraven@roadraven
Already on the plugin? After updating the app, RoadRaven now shows a toast with the exact commands. Or run, then restart Claude Code:
/plugin marketplace update roadraven
/plugin update roadraven@roadraven
/plugin install roadraven-hud@roadraven
Turn on auto-update for the roadraven marketplace in /plugin → Marketplaces to get plugin updates without this step.
Any other MCP host:
claude mcp add -s user roadraven -- npx -y @roadraven/mcp@0.8.9
Installed apps from 0.8.5 on offer this update in-app. Every release ships SHA256SUMS.
Full changelog: CHANGELOG.md · PRs: #47, #48
v0.8.8
RoadRaven v0.8.8
New: RoadRaven HUD for Claude Code
A Claude Code mod that draws a live RoadRaven pane inside your Claude Code session, fed by the RoadRaven MCP server. It opens by itself once RoadRaven is running with a roadmap open; /roadraven opens it any time.
- Active work. Every in-progress node with the agent on it: model, effort, elapsed time, current action and, when it finishes, the tokens it used. Phases that only wait on your acceptance checks show as awaiting UAT.
- UAT. Nodes of type
uatshow once an agent marks them ready. Mark a batch Pass or Fail, with a note per failed item; Send writes every status in one atomic write, appends each failure note to its node and wakes the orchestrator with one summary. - Backlog. Not-started nodes with Run (a one-off agent for that node, after a confirmation) and Next (do this one first).
- Follows the app's theme (Linux in this release; Windows and macOS stay amber).
The orchestrate and work-node skills take nodes marked Next first, and create acceptance checks as uat nodes with test steps.
Fixed
- Agent notes no longer get overwritten in an open notes editor (Edit/Split mode used to save the old text over an agent's append on the next keystroke).
- Selected text in the side panel can be copied, and the panel has a Copy notes button.
Install
Desktop app:
# Windows x64 (PowerShell)
irm https://raw.githubusercontent.com/Shuffzord/RoadRaven/master/install.ps1 | iex
# Linux x86_64
curl -fsSL https://raw.githubusercontent.com/Shuffzord/RoadRaven/master/install.sh | sh
Claude Code plugin (brings the HUD as a dependency; Node.js >= 24):
/plugin marketplace add Shuffzord/RoadRaven
/plugin install roadraven@roadraven
Already on the plugin (0.8.x)? The app's update does not update Claude Code plugins, and Claude Code doesn't refresh third-party marketplaces on its own. Run, then restart Claude Code:
/plugin marketplace update roadraven
/plugin update roadraven@roadraven
/plugin install roadraven-hud@roadraven
To get future plugin updates automatically, turn on auto-update for the roadraven marketplace in /plugin → Marketplaces. (In 0.8.8 the app's update toast doesn't appear for a patch-version difference; fixed in 0.8.9.)
Any other MCP host:
claude mcp add -s user roadraven -- npx -y @roadraven/mcp@0.8.8
Installed apps from 0.8.5 on offer this update in-app. Every release ships SHA256SUMS.
Full changelog: CHANGELOG.md · PRs: #44, #45, #46
v0.8.7
What's Changed
- feat(update): v0.8.7 update card follows the whole update flow by @Shuffzord in #42
- v0.8.7 — plugin skills, MCP Registry metadata, app_not_running fix by @Shuffzord in #43
Full Changelog: v0.8.6...v0.8.7
v0.8.6
What's Changed
- Refactor screenshot generation into modular CLI tool by @Shuffzord in #40
- v0.8.6 — screenshot showcase tooling by @Shuffzord in #39
Full Changelog: v0.8.5...v0.8.6
v0.8.5
v0.8.4
Added
- Status at a glance. Every node card carries a small diagonal ribbon
across its top-right corner in its status colour, next to the stripe it
already had. In Progress cards are a little larger, with a coloured
border and ring. Every node with children says how far along it is
(2 / 5 done), and an In Progress leaf that Claude Code just touched
sayslast event 12s ago. A node's type now shows as a small chip beside the status
badge. - Layout knobs. A new button next to the TB / LR toggle opens three
per-file controls: sibling gap, depth gap and card density (comfortable
or compact). They apply as you drag the slider and are remembered for
that file. - Custom layout. Tick Custom layout in the same popover and cards
become draggable: move a card, its connectors follow, and the position is
remembered for that file and that orientation. Untick to snap back to
the automatic layout without losing the positions; Reset positions
clears them. None of this is written into the roadmap file, so agents
and the MCP tools keep working with the plain tree. - Collapse that stays collapsed. Collapsing a subtree now survives
adding, deleting, moving and pasting nodes, and reopening the file. The
empty-canvas right-click menu gains Expand all, Collapse all,
Collapse to depth 1 and Collapse to depth 2. - More keyboard editing.
Alt+↓(TB) /Alt+→(LR) indents the
focused node under its previous sibling;Alt+↑/Alt+←outdents it
to sit after its parent. Both are in the node's right-click menu too,
with their shortcuts shown for the current layout.
Keys1234set Not Started, In Progress, Completed, Blocked. - Undo and redo.
Ctrl+Zundoes your last edit,Ctrl+Yor
Ctrl+Shift+Zredoes it, up to 50 steps. Typing in the notes editor
counts as one step. Edits made by an agent over MCP are not undone —
only yours.
Changed
- Reorder follows the layout. In TB,
Ctrl+←/Ctrl+→move a node
before or after its neighbour, matching how←/→navigate. The old
Ctrl+↑/Ctrl+↓pair still works in both layouts. - The layout orientation you pick for a file is restored when that file
opens again. It was saved before but never read back. - Opening a different file no longer carries over the previous file's view
settings. - The default layout is roomier: sibling cards sit a little further apart
and levels are further apart, so the tree reads more clearly. Files that
already saved their own layout knobs keep them. - react-d3-tree 3.6.6 → 3.6.7 (maintenance release).
Fixed
- A file's per-file settings could be partly overwritten when one setting
was saved (a layout toggle dropped the file's other stored settings).
What's Changed
- ci(release): stage @roadraven/mcp on npm; manual re-stage for a tag by @Shuffzord in #34
- ci(release): setup-node v6 as npm documents; keep npm debug log on a failed stage by @Shuffzord in #35
- docs: v0.8.3 launch prep — FSL-1.1-MIT, README rewrite, Node 24,
mcp initby @Shuffzord in #36 - Feat/v0.8.4 canvas comfort by @Shuffzord in #37
Full Changelog: v0.8.3...v0.8.4
v0.8.3
What's Changed
- v0.8.3 — Themes: contrast gates, user theme files, in-app editor by @Shuffzord in #33
Full Changelog: v0.8.2...v0.8.3
v0.8.2
What's Changed
- v0.8.2: file management UX — File menu, document chip, sidebar Files/Outline, Preferences by @Shuffzord in #32
Full Changelog: v0.8.1...v0.8.2
v0.8.1
What's Changed
- ci(release): publish @roadraven/mcp from CI via npm trusted publishing by @Shuffzord in #30
- Feat/v0.8.1 canvas focus by @Shuffzord in #27
Full Changelog: v0.8.0...v0.8.1