Skip to content

RoadRaven v0.8.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 23 Sep 19:48
· 192 commits to master since this release
v0.8.0
3dfff6f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

RoadRaven 0.8.0 is the first release since 0.6.0. It makes installing RoadRaven a one-liner, ships the MCP server on npm, and makes the app safe for AI agents to write to.

Install

Windows (PowerShell, per-user, no admin):

irm https://raw.githubusercontent.com/Shuffzord/RoadRaven/master/install.ps1 | iex

Linux (x64):

curl -fsSL https://raw.githubusercontent.com/Shuffzord/RoadRaven/master/install.sh | sh

Both scripts download the installer from this release, verify it against SHA256SUMS, and refuse to install on a mismatch. Manual downloads are below; verify with sha256sum -c SHA256SUMS --ignore-missing or gh attestation verify <file> --repo Shuffzord/RoadRaven.

The Windows installer is unsigned, so SmartScreen shows "Windows protected your PC" on first run. Click More info, then Run anyway.

Connect an AI agent

@roadraven/mcp is now on npm. Three ways in, easiest first:

  1. Setup Wizard — opens on first launch, detects Claude Code and OpenCode, registers both with one click. Works offline.
  2. Claude Code plugin — /plugin marketplace add Shuffzord/RoadRaven, then /plugin install roadraven@roadraven.
  3. Any MCP host — npx -y @roadraven/mcp@0.8.0 (Node.js 22+). Details in the MCP install guide.

The MCP server exposes 21 tools: read the tree, create, rename, move and delete nodes, update status, notes and metadata, batch updates, open and save files.

What's new

Agent-safe writes (0.7)

  • Optimistic locking: every write can pass expectedRevision; a stale write is rejected with the current revision instead of silently clobbering another writer's change.
  • updateNodes batch tool: up to 100 node changes in one atomic call.
  • Canonical JSON on save (stable key order, 2-space indent, LF), so agent edits produce minimal diffs.
  • Stable node ids and a Claude Code hook bridge.

MCP install and versioning (0.8)

  • Setup Wizard registers OpenCode as well as Claude Code, and defers to the Claude Code plugin when that is installed.
  • RoadRaven ships as a Claude Code marketplace plugin, and @roadraven/mcp is published on npm.
  • The app compares the connected MCP server's version with its own and, on a major.minor mismatch, shows how to fix it for the way the server was installed, with a Copy button. A wizard-installed server updates itself at app startup.

Distribution

  • One-line installers for Windows and Linux with checksum verification.
  • Every release ships SHA256SUMS and GitHub build attestations.
  • The Windows installer uses the system WebView2 instead of bundling Chromium: 18 MB instead of ~260 MB.
  • App identifier is now io.github.shuffzord.roadraven; the install location follows it.

Under the hood

  • Migrated to Electrobun 2.0.1 (Cottontail main process). Electrobun-specific code is isolated behind a small platform layer.
  • bun is the required package manager for development; other package managers are rejected at install time.

Fixed

  • An MCP client reconnecting before the main window existed could crash the app on startup.
  • The MCP server reported a hardcoded 0.1.0 version regardless of the package version.
  • The release workflow's upload pattern no longer matched Electrobun 2.x installer names, which would have shipped a release with no installer attached.

Upgrading from 0.6

Install normally. Settings, recent files and backups carry over (they live in %LOCALAPPDATA%\RoadRaven on Windows). The old 0.6 install in %LOCALAPPDATA%\RoadRaven.electrobun.dev\ and its Start-menu shortcut are not removed, because 0.6 had no uninstaller. Delete them by hand.

Known limitations

  • No macOS build.
  • Windows installer is unsigned (SmartScreen warning, see above).
  • No in-app self-update yet: re-run the one-liner to upgrade.

Downloads

  • win-x64-RoadRaven-Setup.zip — Windows x64 installer (unzip, run RoadRaven-Setup.exe, keep the .installer folder beside it).
  • linux-x64-RoadRaven-Setup.tar.gz — Linux x64 installer.
  • SHA256SUMS — checksums for every asset.
  • stable-* files are consumed by the updater; you do not need them.

Full changelog: v0.6.0...v0.8.0 · CHANGELOG.md

Assets 11
Loading