Plannotator：给多智能体工作的本地浏览器评审台
一个给 Claude Code 等 AI 代理用的本地浏览器评审台，能批注计划和代码并把反馈直接发回代理。
GitHub backnotprop/plannotator 更新 2026-11-14 分支 main 星标 10.5K 分叉 785
TypeScript AI 编程代理评审 Plannotator Inbox macOS/Linux/WSL/Windows

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你同时使用 Claude Code、Codex 或 Gemini CLI，需要在代理执行过程中审查计划和反馈。
    README「Plannotator」说明支持这些代理，并会在代理提出决策或计划时打开浏览器评审界面。
  • 你要批注 Markdown、HTML 或其他 interactive artifacts，而不是只审查纯文本日志。
    README 开头写明可 annotate plans、specs、markdown、HTML and other interactive artifacts。
  • 你希望用 Plannotator Inbox 汇总多智能体的 decisions、prototypes、variations 和 plans。
    README「Plannotator Inbox」说明它提供这些内容的 review layer，并支持 coding agents 和 personal assistants。

不适合，如果你

  • 你在原生 Windows 上使用 Codex，且不接受 experimental hooks 或手动设置步骤。
    安装表中 Codex 行明确写着原生 Windows 的 Codex hooks 是 experimental，安装器会打印手动设置步骤。
  • 你使用 Droid 时需要自动拦截 plan mode，而不是只执行 commands。
    安装表的 Droid 行明确写着「Commands only, no plan interception yet」。
  • 你的环境禁止安装器访问 GitHub、npm 或 Ataraxy-Labs/sem。
    README「Install」说明完整安装可能联系 GitHub、Ataraxy-Labs/sem 和 npm；仅使用 --minimal 可跳过 skills、hooks 和 per-agent config。

前置条件

  • macOS、Linux 或 WSL 可使用 install.sh；Windows 使用 install.ps1。
  • Gemini CLI 集成要求 Gemini CLI 0.36.0+。
  • Claude Code、Copilot CLI、Droid 等集成需要各自的 plugin marketplace 或 host CLI 配置。
  • Pi 不走通用安装器，README 要求使用 npm:@plannotator/pi-extension。
  • 安装器会将 plannotator binary 安装到环境中；--minimal 模式安装到 ~/.local/bin。

第一步命令（README 原文）

curl -fsSL https://plannotator.ai/install.sh | bash

要注意

  • 使用 --minimal 后不会安装 skills、hooks、slash commands 或 per-agent config。
    README「Install」对 --minimal 的说明。
  • 更新 Claude Code plugin 需要重启；仅刷新 marketplace 不会更新 plugin。
    README「Updating」明确要求更新后 restart Claude Code，并说明 refreshing the marketplace alone does not update the plugin。
  • 使用 plannotator uninstall --purge 会删除已知本地数据且不可恢复。
    README「Uninstall」说明 purge 需要输入 purge，并明确数据 local-only、cannot be recovered。
  • Codex 在 2.1.287 或更高版本默认可让评审反馈稍后作为消息到达。
    README「Updating」说明 Claude Code 2.1.287 或更新版本的 plan review、code review 和 annotate 不会让 Claude 等待。

材料未说明

  • README 节选未说明支持哪些浏览器及其最低版本。
  • README 节选未给出大规模团队、长时间运行任务或高并发 Inbox 的性能数据。
  • README 节选未提供各类 agent 的完整版本兼容矩阵；除 Gemini CLI 0.36.0+ 外，其他版本要求未知。
  • README 的 Security、Privacy and network behavior、Remote / SSH / devcontainer 章节内容未提供，无法判断具体安全边界和远程环境限制。
  • README 节选未说明 Plannotator Inbox 的部署形态、账号要求或团队权限模型。

💡 深度解析

6
视情况 我在受限企业网络中处理敏感代码，只允许安装 `plannotator` 二进制，不能默认访问 npm、GitHub 解析接口或额外 sidecar；我应该使用完整安装还是 minimal 模式？
适合读者： 在企业受限网络中处理敏感代码、只允许安装单一二进制并需要明确网络边界的安全工程师

视情况：minimal 模式更符合“只装一个二进制”的约束，但它会跳过代理集成配置，不能直接等同于完整工作流。

  • README 说明完整安装除下载 GitHub Release 外，还可能联系 GitHub、Ataraxy-Labs/sem 的可选 sidecar 和 npm 资源。
  • --minimal 只安装 plannotator 到 ~/.local/bin，并跳过所有 skills、hooks、slash commands 与每代理配置，网络和供应链面更小。
  • 项目定位为 local、browser-based review surface，适合敏感代码不直接上传第三方服务；但这不代表安装脚本或代理扩展完全离线。

如果团队能自行完成代理配置并接受仅有核心 CLI，minimal 可行；若必须自动配置 Claude Code、Codex 等集成，则需要额外审核网络边界。

  • Install："A full install can also contact GitHub... Ataraxy-Labs/sem... and npm"
  • Install："Pass `--minimal` ... install only the `plannotator` binary to `~/.local/bin`"
  • Install：minimal 模式跳过 skills、hooks、slash commands 和 per-agent config
  • README 原句："Plannotator is a local, browser-based review surface"
curl -fsSL https://plannotator.ai/install.sh | bash -s -- --minimal
材料未说明：README 节选未提供完全离线安装、预下载校验和二进制签名验证流程；未说明 minimal 模式下各代理集成需要哪些手工文件和权限
适合 我在 macOS、Linux 或 WSL 上使用 Claude Code，希望代理提出计划后自动打开浏览器，让我批准、批注或要求修改，再把结果回传给 Claude Code；Plannotator 是否适合？
适合读者： 在 macOS、Linux 或 WSL 上使用 Claude Code，想在计划执行前进行浏览器审阅并把批注直接回传的个人开发者

适合，因为 README 明确覆盖了 Claude Code 的插件接入、计划审阅和反馈回传。

  • 安装器会自动检测代理并配置 hooks、skills 与 slash commands；Claude Code 仍需执行 /plugin marketplace add backnotprop/plannotator 和安装插件。
  • 产品定位是本地浏览器审阅界面，代理提出 decision、plan、HTML 或完成工作时会打开页面，用户可批注并直接发送反馈。
  • macOS、Linux、WSL 都在统一安装命令的适用范围内；Claude Code 2.1.287+ 还支持审阅后异步返回消息的模式。

如果团队依赖旧版 Claude Code，README 没有说明经典阻塞流程以外的版本兼容边界。

  • Install：macOS / Linux / WSL 安装命令
  • Install：Claude Code `/plugin marketplace add backnotprop/plannotator`
  • README 原句："It plugs directly into your agent through plugins, hooks and commands."
  • Updating："On Claude Code 2.1.287 or newer..."
curl -fsSL https://plannotator.ai/install.sh | bash
材料未说明：README 节选未说明 Claude Code 已有多个插件或自定义 hook 时的冲突处理细节；未提供计划内容大小和超大 diff 下浏览器性能边界
适合 我同时运行 Claude Code、Codex、Gemini CLI 和 OpenCode，不想逐个切换终端；我需要一个 Inbox 集中查看计划、原型、变体和待决策事项，并能把反馈发回原代理，Plannotator 是否值得采用？
适合读者： 同时运行 Claude Code、Codex、Gemini CLI 和 OpenCode，需要集中查看计划、原型与决策的多代理工程师

适合，因为 Inbox 正是 README 针对多代理工作流提供的统一审阅层。

  • README 将 Plannotator Inbox 描述为呈现 decisions、prototypes、variations、plans 的入口，并称其适用于 all coding agents 和 personal assistants。
  • 支持列表同时包含 Claude Code、Codex、Gemini CLI 与 OpenCode，说明你的四个宿主都在目标集成范围内。
  • 接入方式按宿主区分：Claude Code、Gemini CLI 可由插件或 hook 配置，Codex 使用 Stop hook，OpenCode 需要在 opencode.json 添加插件。
  • 浏览器中可以标记、评论并直接把反馈发送给代理，减少跨终端复制上下文的需要。

不过，README 没有给出 Inbox 在大量并行事项下的排序、权限和团队协作规则。

  • README 原句："Plannotator Inbox ... surfaces decisions, prototypes, variations, plans"
  • README 原句："Works with all coding agents and personal assistants."
  • Install：支持 Claude Code、Codex、Gemini CLI、OpenCode
  • README 原句："mark it up, comment, and send feedback directly to the agent"
curl -fsSL https://plannotator.ai/install.sh | bash
材料未说明：README 节选未说明多代理 Inbox 的排序、归档和通知机制；未说明多个代理同时回传同一项目时如何区分会话和权限
适合 我使用 Gemini CLI 0.36.0 以上，要求计划、Markdown、规格说明和交互式 HTML 原型都能在浏览器中批注，并将反馈送回代理；Plannotator 是否比纯终端审阅更合适？
适合读者： 使用 Gemini CLI 0.36.0 以上并需要在计划模式审阅 Markdown、规格说明和 HTML 原型的产品工程师

适合，因为它同时覆盖 Gemini CLI 的自动接入，以及计划、文档和 HTML artifact 的视觉化批注。

  • README 对 Gemini CLI 的要求是 0.36.0+，并说明 hook、policy 和 slash commands 会自动配置，安装后不需要额外插件命令。
  • 产品描述明确支持 annotate plans、specs、markdown、HTML 和其他 interactive artifacts，也支持 review diffs and PRs。
  • 代理提出 plan、HTML 或其他产物时，浏览器会打开审阅页面，用户可标记、评论并直接发送反馈。
  • 这比只读终端文本更适合需要定位视觉结构、原型交互或具体文档位置的审阅流程。

但 README 未说明复杂 HTML 是否保留全部浏览器运行时能力，也未说明超大型文档的加载上限。

  • Install：Gemini CLI："Requires Gemini CLI 0.36.0+"
  • Install："The hook, policy, and slash commands are configured automatically"
  • README 原句："Annotate plans, specs, markdown, HTML, and other interactive artifacts."
  • README 原句："When the agent proposes a decision, plan, html... the app opens in your browser"
curl -fsSL https://plannotator.ai/install.sh | bash
材料未说明：README 节选未说明复杂 HTML 中脚本、外部资源和交互状态的保留范围；未说明 Gemini CLI 0.36.0 以上各小版本的兼容边界
视情况 我在原生 Windows 上使用 Codex CLI，要求代理进入计划阶段时自动拦截并打开审阅界面，而不是只提供手动命令；Plannotator 是否满足？
适合读者： 在原生 Windows 上使用 Codex CLI、需要自动计划拦截的开发者

视情况：Codex 的计划审阅能力存在，但原生 Windows 的自动化程度低于 macOS、Linux 和 WSL。

  • README 说明 Codex 通过实验性的 Stop hook 自动启用计划审阅，支持范围写明为 macOS/Linux/WSL。
  • 对原生 Windows，README 明确指出 Codex hooks 仍属 experimental，安装器只打印手动设置步骤，因此不能把“一键自动拦截”作为确定能力。
  • $plannotator-review、$plannotator-annotate 和 $plannotator-last skills 会随 Codex 集成提供，仍可作为手动入口。

若你的硬约束是原生 Windows 下稳定、无需手动配置的自动拦截，当前资料不足以支持选用；若能接受手动设置或改用 WSL，匹配度更高。

  • Install：Codex 条目："Nothing. Plan review is enabled automatically via Codex's experimental `Stop` hook (macOS/Linux/WSL...)"
  • Install："on native Windows, Codex hooks are experimental and the installer prints manual setup steps"
  • Install：Codex skills `$plannotator-review`, `$plannotator-annotate`, `$plannotator-last`
irm https://plannotator.ai/install.ps1 | iex
材料未说明：README 节选未说明原生 Windows 手动设置的完整步骤；未说明不同 Codex CLI 版本对实验性 Stop hook 的具体兼容矩阵
视情况 我在 SSH 或 devcontainer 中运行 OpenCode，代码不能离开开发环境，但我希望在本地浏览器审阅 diff、计划和文档，并把评论回传 OpenCode；Plannotator 是否适合这种部署？
适合读者： 在远程 SSH 或 devcontainer 中运行 OpenCode，需要浏览器审阅但不希望把代码迁移到第三方云服务的开发者

视情况：项目明确考虑 Remote、SSH 和 devcontainer，但本地浏览器与远程代理之间的网络转发和访问控制仍是部署前提。

  • 项目洞察将远程开发适配列为功能范围，说明目标包含 Remote、SSH 和 devcontainer 场景。
  • README 将其定位为 local、browser-based review surface，且反馈通过宿主代理回传，不是把代码默认交给云端服务处理。
  • OpenCode 的接入需要在 opencode.json 添加 "plugin": ["@plannotator/opencode@latest"] 并重启，远程环境仍需完成这项配置。
  • 链接分享、远程环境和团队协作会增加访问控制与数据暴露风险，不能直接按单机本地模式处理。

如果能建立安全端口转发并控制浏览器访问，匹配度较高；README 未说明具体转发命令、认证方式或跨容器回传拓扑。

  • 项目洞察："远程开发适配：README 所列功能范围包含 Remote、SSH 和 devcontainer 场景"
  • README 原句："Plannotator is a local, browser-based review surface"
  • Install：OpenCode 需要在 `opencode.json` 添加插件并重启
  • 项目洞察 common pitfalls：远程环境和链接分享涉及额外访问控制与数据暴露风险
材料未说明：README 节选未提供 SSH 端口转发、devcontainer 端口暴露和浏览器访问的具体命令；未说明远程会话的身份认证、TLS 和跨机器权限模型

✨ 核心亮点

  • 支持 Claude Code、Codex、Gemini CLI 等多种代理
  • Plannotator Inbox 覆盖决策、原型、计划与反馈
  • 一条安装命令自动配置 hooks、skills 和 slash commands
  • 完整安装会访问 GitHub、npm 与可选 sem sidecar

🔧 工程化

  • 浏览器中批注计划、Markdown、HTML 和交互式 artifacts
  • 通过 hooks、plugins 和 commands 把反馈发回代理
  • Code Review 支持审查 diffs 与 pull requests
  • Plannotator Inbox 可与 Grok Bot、Muse、Hermes 协作

⚠️ 风险

  • 完整安装会联系 GitHub Releases、npm 和 Ataraxy-Labs/sem
  • 原生 Windows 的 Codex hooks 仍属 experimental
  • Gemini CLI 集成要求版本 0.36.0 或更高
  • Droid 当前只有 commands，尚无 plan interception

👥 适合谁？

  • 使用 Claude Code、Codex 或 Gemini CLI 的 AI 开发团队
  • 需要审查计划、diffs、PR 和 HTML artifacts 的工程师
  • 在 macOS、Linux、WSL 或 Windows 上运行代理的用户
  • 需要统一管理多代理反馈的个人助手用户