# Plannotator — Visual Plan & Diff Review for Agents

> Plannotator is a plan + code review UI that lets you annotate agent plans and diffs as structured feedback across Claude Code, Codex, and Gemini CLI.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

1. Install / set up:
   ```bash
   curl -fsSL https://plannotator.ai/install.sh | bash
   ```
2. Start / smoke test:
   ```bash
   # In Codex
!plannotator review
   ```
3. Verify:
   - Run `!plannotator review` and confirm it opens the UI and lets you leave at least 3 inline annotations on the current diff.

## Intro

Plannotator is a plan + code review UI that lets you annotate agent plans and diffs as structured feedback across Claude Code, Codex, and Gemini CLI.

- **Best for:** Teams who want faster agent plan approvals and higher-signal code review than chat transcripts
- **Works with:** Codex Desktop + CLI hooks; also supports Claude Code / Gemini CLI integrations
- **Setup time:** 5 minutes

## Practical Notes

- Setup time ~5 minutes (run the install script and restart your client if needed)
- Measurable workflow: 1 plan or diff reviewed with 3+ inline annotations
- GitHub stars + forks (verified): see Source & Thanks

Plannotator is most effective when you standardize what “approval” means:

- Require a plan diff review before implementation starts.
- Tag each annotation as: scope, risk, missing test, or unclear requirement.
- Keep a strict minimum: 3 annotations per non-trivial change.

If you combine this with a small set of repo rules (forbidden actions, review-required operations), you can turn agent work into a predictable, auditable loop.

### FAQ

**Q: Does it work only with Codex?**
A: No. The README lists integrations for multiple coding agents; Codex is one of them.

**Q: How do I install it?**
A: Run the install script, then use the provided commands (e.g., `!plannotator review` in Codex).

**Q: What should I review first?**
A: Start with plans: annotate scope/risk before the agent writes code.

## Source & Thanks

> Source: https://github.com/backnotprop/plannotator
> License: Apache-2.0
> GitHub stars: 5,195 · forks: 359

---

<!-- ZH -->

## 快速使用

1. 安装 / 设置：
   ```bash
   curl -fsSL https://plannotator.ai/install.sh | bash
   ```
2. 启动 / 冒烟测试：
   ```bash
   # In Codex
!plannotator review
   ```
3. 验证：
   - 运行 `!plannotator review`；确认能打开 UI，并对当前 diff 至少留下 3 条行内标注反馈。

## 简介

Plannotator 提供浏览器里的计划与代码评审界面：可对 plan、diff 做标注并输出结构化反馈，支持与 Claude Code/Codex/Gemini CLI 等 coding agents 集成。

- **适合谁：** 想把 agent 计划审批与代码评审做得更快、更像工程评审的团队
- **可搭配：** 可与 Codex Desktop 的 hooks/命令配合使用，也支持 Claude Code / Gemini CLI
- **准备时间：** 5 分钟

## 实战建议

- 准备时间约 5 分钟（运行安装脚本，必要时重启客户端）
- 可量化流程：评审 1 个 plan 或 diff，并产生 3+ 条行内标注
- GitHub stars / forks（已核验）：见「来源与感谢」

Plannotator 的效果取决于你是否把“审批/评审”标准化：

- 实施前先做 plan diff 评审。
- 每条标注都归类：范围、风险、缺测试、需求不清。
- 对非小改动设最低标准：至少 3 条标注。

再配合一套仓库规则（禁止动作、必须复核的操作），就能把 agent 工作从聊天记录变成可审计的工程闭环。

### FAQ

**只能配合 Codex 用吗？**
答：不是。README 列出多种 coding agent 集成方式，Codex 只是其中之一。

**怎么安装？**
答：运行安装脚本，然后按客户端支持使用对应命令（例如 Codex 里 `!plannotator review`）。

**先评审什么最值？**
答：先评审 plan：在写代码前把范围与风险标清楚。

## 来源与感谢

> Source: https://github.com/backnotprop/plannotator
> License: Apache-2.0
> GitHub stars: 5,195 · forks: 359


---
Source: https://tokrepo.com/en/workflows/plannotator-visual-plan-diff-review-for-agents
Author: Script Depot