RoadRaven
A keyboard-first desktop editor for visual roadmap trees. Built on Electrobun (not Electron); runtime is Bun.
Quick links
| What | Where |
|---|---|
| Install (Windows + Linux) | README — install |
| Connect an MCP host (Claude Code, OpenCode, etc.) | MCP install guide |
| Architecture overview | Architecture |
| Local development | Development guide |
| RPC contract reference | RPC and IPC |
| Design system + tokens | Design system |
| Structured logging | Logging |
| Build a producer for the Event API | Plugin authoring guide |
What’s in v1
- Keyboard-first roadmap editor (read + write)
- JSON schema-driven node types and statuses
- Live status updates from external producers via WebSocket Event API
- Reference Event Producer:
@roadraven/mcp— MCP wrapper for Claude Code and any other MCP host (npm publish pending — see Packages on npm below)
What’s NOT in v1 (deferred to v1.1+)
- macOS
.dmginstaller - Canary release channel
@roadraven/reactcomponent package- Smart-adapter Plugin System (the in-app
RoadmapPluginhost) - Code signing (Authenticode / GPG / notarization)
See the README — feature status for the full v1 vs. v1.1 split.
Packages on npm
@roadraven/mcpis on npm (pin the version matching your app, e.g.@roadraven/mcp@0.8.4);@roadraven/coreis not published yet — see the main README’s Packages section.
@roadraven/core— Zod schemas + types (zero desktop deps)@roadraven/mcp— MCP wrapper that lets Claude Code (and any MCP host) push live updates to a running app; see the MCP install guide