📌 项目地址：backnotprop/plannotator | ⭐ 10,360 颗星 | 🔧 TypeScript
问题出在哪
让 Claude Code、Codex 这类编程代理干活，最别扭的环节不是生成，是审阅。代理甩出一份计划、一个 HTML 原型、一段代码改动，你想逐行挑毛病提意见，可通道太粗糙：在终端里翻看长输出，把意见复制粘贴回对话，一来一回，格式还容易乱。代理多了以后更糟，几个会话同时跑，你根本不知道哪个在等你拍板。
Plannotator 干的事一句话能说清：它在本地跑一个浏览器界面，代理提出计划、生成 HTML 或者干完活之后，浏览器自动打开，你在上面圈点、评论、审 diff，点发送，反馈直接回到那个代理，变成它的下一轮输入。
四块功能
文档批注。 计划、规格、代理消息、HTML 都能标注，批注完发给代理处理。
代码审查。 审本地改动或远程 PR，在 diff 上评论、提代码建议，评论回到代理手里。版本控制支持很宽：Git、GitButler、Jujutsu（jj）、Perforce（p4）、GitHub、GitLab。内置 AI，可以针对正在审的内容提问，也可以发起 AI 审查，让它自动往 diff 上贴评论。
Plannotator Inbox。 这是新主打。一个本地窗口，代理边干活边把消息、问题、文件、引导式审阅丢进来。你点一下回答问题，批注一个文件，有空再按发送。关键在于：代理不会挂着会话干等你，你的回复会送回当初提问的那个会话。同时跑多个代理的人应该懂这个价值。
终端批注。 配套仓库 herdr-annotate 把同样的审阅体验搬进终端，可以在 Herdr 里标注终端文本、整篇 Markdown 和代理回复。独立项目，可选项。
怎么用
README 给出的核心命令：
plannotator inbox
接入方式分几档：
- Claude Code、Pi、OpenCode 走 Plannotator 的插件直连，你的回复作为它们的下一轮输入送达
- 其他代理走 MCP，运行
plannotator inbox mcp - 还有个取巧办法：
plannotator inbox --help本身就是写给代理看的指南，让代理自己读去
支持的编程代理有 Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、DeepSeek Harness、Pi。Inbox 也接个人助理类代理：Grok Bot、Muse、Hermes、OpenClaw。安装步骤 README 没细写，去 plannotator.ai 查文档。
和普通 code review 工具的区别
GitHub PR 审查工具的终点是”人看完了”，Plannotator 的终点是”代理收到反馈继续干活”。这是根本差异。
审阅对象也不只代码。计划、规格、Markdown、交互式 HTML 全在范围内，这对”先出 plan 再动手”的代理工作流很对路：你在它动手前就把计划里的坑标出来，省得返工。
再加上本地运行、浏览器承载，代码不用出你的机器。Inbox 的异步设计也让代理不用停下来等你，这点前面说过了。
几个要留心的
- 项目迭代很快，README 里已经有标 “(Legacy)” 的旧功能（旧版 Plan Mode），用之前看一眼官方文档确认当前推荐路径
- 浏览器要渲染代理生成的 HTML 工件，只加载你信得过的代理产出
- README 没提许可证，商用前去仓库确认
一万多 star，TypeScript 写的，作者明显在快速加功能。如果你天天跟编程代理打交道，被”反馈怎么递回去”这个问题烦过，值得装一个试试。