为 Claude Code、Copilot CLI、Gemini CLI 等 AI 编码代理提供可视化计划审核与 PR 风格代码审查的本地优先工具。
Plannotator 是一个面向 AI 编码代理的可视化审核工具，核心解决代理计划审批和代码审查环节中纯文本交互的局限性。
计划审查（Plan Review）#
通过 agent hook 拦截代理的计划审批步骤，自动在浏览器中打开可视化审核界面，支持内联标注（删除、插入、替换、评论）、自动 Plan Diff、版本历史与版本间对比。用户 Approve 后代理继续执行，Request Changes 则将标注作为结构化反馈发送回代理。
代码审查（Code Review）#
提供 PR 风格的 diff 查看器，支持并排或统一视图、文件树导航、行级标注与代码建议，可审查本地未提交更改或远程 GitHub/GitLab PR。
标注（Annotate）#
标注功能可扩展至任意 Markdown、HTML、URL 或文件夹。通过 /plannotator-annotate <目标> 或 /plannotator-last 命令触发，支持 --gate、--json、--silent-approve 标志。
分享与协作#
小型计划通过 URL hash 编码分享（无需服务器）；大型计划使用端到端加密短链接（AES-256-GCM 浏览器端加密，服务端仅存储密文，类似 PrivateBin 零知识方案）。粘贴内容 7 天后自动删除，支持同事标注后导入反馈发回代理。
本地优先与可靠性#
所有计划处理在本地完成，计划数据不离开用户机器。标注自动保存，支持崩溃/重启后恢复。
架构与实现#
Monorepo 结构，使用 apps/、packages/ 目录组织代码，由 bun 管理依赖。前端基于 Astro 构建，TypeScript 为主语言（86.8%）。各 AI 代理有独立适配包（Claude Code、Copilot CLI、Gemini CLI、OpenCode、Pi、Codex）。通过 CLAUDE.md / AGENTS.md 提供代理技能描述。CI/CD 由 GitHub Actions 驱动，Renovate bot 自动依赖更新。
支持的 AI 代理#
Claude Code、GitHub Copilot CLI、Gemini CLI（≥0.36.0）、OpenCode、Pi、Codex。
编辑器与笔记工具集成#
- VS Code：在编辑器标签页中打开计划，支持 diff 视图和编辑器标注（Marketplace 发布状态待确认）
- Obsidian：自动保存计划到 vault，带 frontmatter 和标签
- Bear：保存计划带嵌套标签和项目元数据
安装#
macOS / Linux / WSL：
curl -fsSL https://plannotator.ai/install.sh | bash
Windows PowerShell：
irm https://plannotator.ai/install.ps1 | iex
Claude Code 集成：
/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator
支持完全自托管方案，具体步骤见仓库 docs 目录。
当前版本 v0.19.1（87 个 release），74 位贡献者。自 v0.19.0 起采用 Apache-2.0 或 MIT 双许可（此前为 BSL-1.1）。