跳到正文
Hacker News· Shuffzord·· 8 天前AI 评分58

RoadRaven：让编码智能体实时更新项目计划的本地工具

Show HN: RoadRaven – a project plan your coding agents keep up to date

AI 导读

RoadRaven 发布 alpha v0.8.9，把项目计划存为仓库里的 roadmap.json，渲染成树状视图，任何能开 WebSocket 的进程都能实时翻转节点状态。

正文 · AI 翻译

会自我监视的计划。 一个本地桌面端的项目计划树，其中每个节点都可以连接到真实的事物（Claude Code 任务、CI 作业、脚本），并随着工作的进行自动切换状态。

Latest release License: FSL-1.1-MIT Platform: Windows | Linux MCP server on npm

RoadRaven: a project plan as a tree, with live status on every node

你在文档里做计划。而工作却发生在终端、CI 和 AI 代理中。不出一天，文档就成了虚构。RoadRaven 把计划和实际工作放在同一个地方：你仓库里一个普通的 roadmap.json，以树形呈现，由真正在做工作的任何东西通过本地 WebSocket 实时更新。没有云端，没有账户，没有冲刺，没有故事点。只有一个属于你自己的文件。

最核心的用例：把路线图交给 Claude Code（或任何 MCP 主机），然后看着它规划、执行，并在你的监督下把节点一个个变绿。

Alpha（v0.8.9）。 核心编辑功能和实时 Event API 目前已经可用。数据格式、API 和打包方式在 v1.0 之前仍可能变化。非常欢迎通过 Issues 提交 bug 报告和功能请求。

60 秒快速上手

1. 安装（目前支持 Windows 和 Linux；macOS 即将推出）。

Windows x64，PowerShell。下载最新版本，用该版本的 SHA256SUMS 进行校验，然后运行安装程序：

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

由于 alpha 版本未签名，Windows SmartScreen 会提示“Windows 已保护你的电脑”。点击 更多信息，然后点击 仍要运行。手动下载、版本固定和校验和步骤：安装详情。

2. 连接 Claude Code。 启动 RoadRaven。首次运行的 设置向导 会检测 Claude Code 和 OpenCode，并一键注册捆绑的 MCP 服务器。无需命令，可离线使用。重启你的 MCP 主机，工具即可使用。

3. 试一试。 从欢迎屏幕打开一个示例，然后告诉 Claude Code：

Read the open RoadRaven roadmap, pick the first todo node, do the work, and set its status as you go.

随着代理工作，画布上的节点会改变颜色。这就是整个理念。

演示

roadraven-showreel.mp4

RoadRaven's own 0.8 release line: six versions shipped, the seventh in flight, each phase attributed to the agent that did it

The 0.8.6 subtree with the node panel open: status, type, notes and the agent badge on every card

Live event log: every MCP tool call streams into a filterable feed over WebSocket

为什么选择 RoadRaven

  • 计划即文件。 路线图就是你仓库里的普通 JSON。可 diff、可审查、属于你自己。没有数据库，没有专有格式。
  • 来自任何事物的实时状态。 任何能打开 WebSocket 的进程都可以更新节点。GitHub Action 完成，节点变绿。Claude Code 完成任务，节点更新。
  • 为代理监督而构建。 MCP 服务器暴露 21 个工具，让代理可以在工作时创建、编辑、移动、删除节点并推送状态。你负责观察；它负责让计划保持最新。
  • 本地优先。 绑定到 127.0.0.1，可在气隙环境中工作。任何数据都不会离开你的机器。
  • 键盘优先。 无需鼠标即可导航和编辑整棵树。
  • 零预设 schema。 状态、类型和层级由你定义。应用保持简单；你的工具负责表达。

连接 MCP 主机

三种方式，从最简单的开始。每条路径都需要桌面应用正在运行：工具通过本地 Event API 与它通信，否则会返回 app_not_running。

设置向导（推荐）。 已在 60 秒快速上手 中描述。可随时通过顶部栏的 ⚙ 按钮重新打开。它会写入 ~/.claude.json（Claude Code）和 ~/.config/opencode/opencode.json（OpenCode），不会触碰你已配置的其他服务器。如果下面提到的 Claude Code 插件已经安装，向导会优先使用它。

Claude Code 插件。 需要 Node.js >= 24。在 Claude Code 中执行：

/plugin marketplace add Shuffzord/RoadRaven
/plugin install roadraven@roadraven

Claude Code 不会自行刷新第三方市场：在 /plugin → Marketplaces 中为 roadraven 开启自动更新，或者当应用提示插件已过时时，在 /plugin update roadraven@roadraven 之前运行 /plugin marketplace update roadraven。

任何其他 MCP 主机。需要 Node.js >= 24。固定与你已安装应用相匹配的版本（版本不一致时应用会发出警告）：

claude mcp add -s user roadraven -- npx -y @roadraven/mcp@0.8.9

让 Claude 使用它。仅靠工具无法让 Claude 有理由在路线图中进行规划。这会在 CLAUDE.md 中添加一个简短的 RoadRaven 部分，首先询问是将其放入当前项目，还是放入 ~/.claude/CLAUDE.md 以应用于每个项目。可安全重复运行；它只更新自己的区块，不触碰其他内容：

npx -y @roadraven/mcp@0.8.9 init

Cursor、Codex、Copilot、Gemini、OpenCode、版本不匹配处理，以及从源码构建的路径：MCP 安装指南。

要编写自己的生产者（CI 任务、脚本、机器人）？Event API 契约见插件编写指南。 @roadraven/core（Zod schema 和类型）尚未发布到 npm；请从源码构建。

Claude Code 的技能

安装 Claude Code 插件还会带来两项技能（Setup Wizard 和 npx 路径只提供工具）。roadraven:orchestrate 将一项工作规划为路线图树，并使用子代理逐阶段运行；roadraven:work-node 是每个任务认领节点、向其写入检查点并汇报的方式。详情见插件 README。试试：

Plan the CSV export feature as a roadmap in RoadRaven and run it phase by phase.

Claude Code HUD

一个用于 Claude Code 的 mod：一种全新的扩展类型，可改变 Claude Code 自身的界面，这里是在你的终端会话中嵌入一个实时 RoadRaven 窗格。

  • 每个节点的实时代理，包含模型、投入程度和当前操作
  • 批量通过或失败的 UAT 检查，会唤醒编排器
  • 待办事项的 Run / Next 按钮
  • 跟随应用主题

UAT section with Pass and Fail buttons

随插件提供：/plugin install roadraven@roadraven。详情 →

安装

从 GitHub Releases 下载。 自 v0.8.0 起的每个版本都附带一个 SHA256SUMS 文件。

Windows x64。使用上面的一行命令，或手动操作：

  1. 下载 win-x64-RoadRaven-Setup.zip 和 SHA256SUMS。校验下载文件（匹配时输出 True）： (Get-FileHash win-x64-RoadRaven-Setup.zip).Hash -eq (Select-String -SimpleMatch ' win-x64-RoadRaven-Setup.zip' SHA256SUMS).Line.Split(' ')[0]
  2. 解压 zip 并运行 RoadRaven-Setup.exe。
  3. SmartScreen：更多信息，然后仍要运行。RoadRaven 在 alpha 阶段未签名。

RoadRaven 在 Windows 上通过系统 WebView2 运行时渲染，因此下载包不包含捆绑的浏览器引擎。在一行命令前使用 $env:ROADRAVEN_VERSION = 'v0.8.9' 固定版本。

Linux x86_64。使用上面的一行命令，或手动操作：

sha256sum -c SHA256SUMS --ignore-missing
tar -xzf linux-x64-RoadRaven-Setup.tar.gz
chmod +x ./installer
./installer

安装程序将应用放在 ~/.local/share/ 下，并创建桌面快捷方式。Chromium（CEF）随附捆绑，因此不依赖系统浏览器。在 sh 前使用 ROADRAVEN_VERSION=v0.8.9 固定版本。

安装后，RoadRaven 会检查 GitHub Releases 以获取更新，并在下载前询问。

状态

截至 v0.8.9 已发布 下一步
树形画布、键盘编辑器、侧面板 markdown 笔记和元数据 macOS 安装程序
原子自动保存、$ref 拆分文件、文件菜单、大纲导航器 代码签名
基于 WebSocket 的 Event API、代理安全写入（乐观锁定、批量更新） 拖放重新指定父级
npm 上的 MCP 服务器、Setup Wizard、带 orchestrate 和 work-node 技能及 HUD mod 的 Claude Code 插件 npm 上的 @roadraven/core 和 @roadraven/react
8 个带 WCAG 对比度门槛的主题、用户主题文件、应用内主题编辑器
应用内更新：启动时检查，下载前询问，重启以安装
带校验和的 Windows 和 Linux 安装程序 .deb 打包
撤销 / 重做、状态条带、按文件布局调节项、可拖拽自定义布局、持久折叠

完整功能列表和键盘参考：docs/features.md。 发布历史：CHANGELOG.md。

文档

贡献

RoadRaven 基于 Electrobun（而非 Electron）构建，运行时使用 Bun。本地环境搭建、测试命令、代码风格 和项目约定见 CONTRIBUTING.md。

bun install
bun run dev:hmr       # Vite HMR + Electrobun
bun run verify        # tests + typecheck + build + lint

来自创建者的一段话

我开发 RoadRaven 是为了解决自己的痛点。当你处理一个 有很多变动部分的任务时，你的计划和实际工作很快就会脱节。计划 存在于文档或你的脑海中，而真实状态却散落在终端、 CI 和 AI 代理之间。文档在你写下的那一刻就已过时，并慢慢变成 虚构。

它最初只是一个个人学习和项目追踪器。真正让我豁然开朗的一刻，是 看着节点在 Claude Code 处理任务时自行翻转状态。我 什么都没碰，只是打开应用，当前状态就 呈现在眼前。这就是整个理念：你的计划，自我观察。

如果你有想法、遇到不顺手的地方，或者想让某个节点监视我还没 想到的东西，请提交 issue 或 PR。

— Shuffzord

许可证

Functional Source License 1.1, MIT future license（FSL-1.1-MIT）， 与 Sentry 使用的许可证相同。简单来说：

  • 你可以将它用于任何用途，无论在家还是工作，免费，包括 在公司内部使用。修改它、fork 它、随你自己的工具一起发布。
  • 唯一不能做的事是将 RoadRaven 本身（或它的一个简单 fork）作为竞争产品出售或托管。
  • 每个版本在发布两年后自动转为纯 MIT 许可。 没有任何东西会被永久锁住。

不是 OSI 定义的“开源”，但很接近：源码可用、免费使用、到期转为 MIT。

来源：Hacker News · github.com

Agent 智能体开源生态MCP 与工具调用产品更新#产品更新#Agent#MCP/工具调用#开源/仓库