用 Claude Code、Codex 写代码时,最难受的环节不是等它写完,而是它写完之后你怎么审:计划合不合理、改动有没有跑偏、想提的意见怎么一句句说清楚。Plannotator 就是补上这一环的开源工具——一个跑在本地浏览器里的审稿台,Agent 拿出计划、文档、HTML 或代码 diff,你直接在上面划线批注,点一下发送,意见就回到 Agent 手里继续干活。它登上今天 GitHub Trending 日榜第一,11,170 星,Apache-2.0 协议,免费开源。

它解决什么问题
现在 AI 编程助手的工作流里,人往往是最后一道关:Agent 在终端里一口气写完计划、改完代码,你只能在终端输出里翻,或者切到编辑器里自己看 diff 再口头指挥它改。Plannotator 把“审”这一步变成一个可视化界面:Agent 一拿出需要你过目的东西,审稿界面就在浏览器里自动打开,你像改稿子一样划线、写批注、点发送,Agent 收到反馈接着改,不用你来回复制粘贴。
支持的 Agent 很全:Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、DeepSeek Harness 和 Pi,通过插件、钩子和命令接入;新出的 Plannotator Inbox 还能接 Grok Bot、Muse、Hermes、OpenClaw 这类个人助手。
三大能力:批注、审代码、收件箱
批注文档与计划。计划、规格文档、Markdown、HTML 产物都能打开批注。Agent 写完计划先别急着动手,你在文档上高亮一段、写一句“这里换个方案”,发回去它就按你的意思改。Plan mode 不用敲命令,靠各 Agent 的钩子自动触发:Agent 一建计划,审稿界面就弹出来。
代码审查。审本地未提交的改动,也能审 GitHub PR 和 GitLab MR,文件树加并排 diff,逐行写意见、提修改建议,批注直接回到 Agent 那里。支持 Git、GitButler、Jujutsu(jj)、Perforce(p4),也内置 AI:可以就正在审的内容向 AI 提问,或者发起一次 AI 审查,让它把意见写到 diff 上。

Plannotator Inbox:多 Agent 的统一收件箱。这是最近主推的新功能:一个本地窗口收拢所有 Agent 留给你的消息、问题、文件和待审内容。你不用守着某个会话等它问完,点一下回答问题、批注文件,按发送就行,回复会回到当初提问的那个会话里。Claude Code、Pi 和 OpenCode 通过插件接入,其他 Agent 走 MCP(plannotator inbox mcp)。

终端里也能审
常驻终端的人不用切浏览器:Herdr Annotate 把同一套批注能力带进终端,可以直接审 Markdown 文档和 Agent 的回复,批注存在 Plannotator 的数据目录里,和浏览器端互通。装法是 herdr plugin install plannotator/herdr-annotate;只想要终端版也可以单独装 TUI:brew install plannotator/tap/plannotator-tui。
安装:一行命令
macOS、Linux、WSL 一条命令装好,安装器会自动识别你装了哪些 Agent 并配好钩子、Skill 和斜杠命令:
curl -fsSL https://plannotator.ai/install.sh | bash
只想要二进制文件不装插件,可以加 --minimal。Claude Code 用户也可以走插件市场:先 /plugin marketplace add backnotprop/plannotator,再 /plugin install plannotator@plannotator,重启即可。装好后常用的命令是 /plannotator-annotate(批注文件、文件夹或网址)、/plannotator-review(审本地改动或 PR)、/plannotator-last(批注 Agent 上一条消息)。在 Claude Code 2.1.287 及更新版本上,审稿时 Claude 不会干等,你的决定会以新消息的形式稍后送达。
隐私:数据默认不出本机
Plannotator 明确表示不收集使用遥测与分析数据,计划、diff、批注、草稿、历史和配置默认都留在本地。唯一需要注意的两点:每次打开审稿面会向 GitHub 查一次最新版本(不发任何内容,可关);分享链接时,小内容直接压进 URL 片段(未加密),大内容用 AES-256-GCM 加密后传到粘贴服务、7 天过期,不想用可以 PLANNOTATOR_SHARE=disabled 一关了之。
适合谁
每天让 Claude Code、Codex 这类 Agent 写代码、写计划的人最适合:Agent 产出越多,越需要一个“人审一遍”的环节。团队协作方向官方正在推托管产品 Workspaces(在排队),开源版的异步链接分享则在慢慢淡出。如果你已经在用 Claude Code 做结对开发,可以顺手看看本站之前整理的把 Claude Code 接进 CI:一次真实跑通的 PR 审查门禁教程;想把 Agent 关进沙箱里跑、再配上这套审稿流程更稳,可以看Claude Cage:给 Claude Code 配一个隔离虚拟机工作台;它也支持以 Skill 方式接入,搭配Modern Web Guidance:Chrome、Edge、Firefox、MDN 联合出品的编程智能体 Skill 包一起用效果更好。
项目地址:GitHub:backnotprop/plannotator;官网:plannotator.ai。
转自 GitHub 作者 backnotprop 的项目《Plannotator》,原文链接









