What Is Plannotator? A Free Tool to Annotate AI Agent Plans
and Diffs in the Browser and Send Feedback Back [vs. Plan Mode, herdr, hunk, GitHub PR Review]
Plannotator is a free, open-source local tool that lets you annotate an AI coding agent's plans and diffs in the browser and send the feedback straight back to the agent. It works with Claude Code, Codex, Gemini CLI and more. This guide covers install, usage, how it differs from plan mode, herdr, hunk and GitHub PR review, and data handling. Updated Nov 2026.
Plannotator is a local review tool that lets you annotate an AI coding agent's plans and diffs in the browser and send that feedback straight back to the agent. It is built by backnotprop, the local plugin is free and open source, and it works with Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode and many other agents.
The GitHub repository was created on December 28, 2025, and the first release, v0.1.0, was published on December 29, 2025. It is dual-licensed under Apache 2.0 or MIT, at your option. As of November 16, 2026 it has about 11,800 stars, the latest release is v0.28.65 (published November 15, 2026), and it has been climbing GitHub Trending this week.
Why it is getting attention now
The longer the jobs you hand to an agent, the more often you want to fix the plan before it runs, or give instructions on a specific line of the resulting diff. Replying in prose in the terminal makes it unclear which part you mean. Plannotator opens plans and diffs in a browser review screen, where you mark up the exact spot and send it back, bringing something close to PR review into the agent workflow.
The README describes it as a workspace for staying in the loop and on top of agents. It now goes beyond plan review to code review, an Inbox that collects messages from several agents, and terminal options in Herdr Annotate and Plannotator TUI. It went from v0.1.0 to v0.28.65 in under a year, so development is very active.
What it can do
| Feature | What it does |
|---|---|
| Plan review | Add inline comments, deletions or replacements to an agent's plan and send them back. Includes diffs between plan revisions and draft auto-save |
| Annotate | Mark up plans, specs, Markdown, HTML and fetched URLs, then send the feedback to the agent |
| Code review | Review local changes or remote PRs/MRs in a diff viewer. Works with Git, GitButler, Jujutsu and Perforce, plus GitHub and GitLab. Optional AI review and "ask AI" |
| Plannotator Inbox | One local window for messages, questions, files and guided reviews from multiple agents; replies go back to the session that asked |
| Herdr Annotate | Review terminal text and Markdown inside herdr |
| Plannotator TUI | Standalone terminal document review that runs without herdr |
| Integrations | VS Code, Obsidian, Bear, Notion |
Supported coding agents include Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, DeepSeek Harness and Pi. The Inbox also covers personal-assistant agents such as Grok Bot, Muse, Hermes and OpenClaw. Claude Code, Pi and OpenCode connect to the Inbox through plugins; other agents use MCP.
Installation and pricing
The local plugin is free and open source. Workspaces, the hosted team product, is separate; the official site lists it as a waitlist and gives no pricing.
| Environment | Method | |
|---|---|---|
| macOS / Linux | `curl -fsSL https://plannotator.ai/install.sh \ | bash` |
| Windows (PowerShell) | `irm https://plannotator.ai/install.ps1 \ | iex` |
| Minimal install | `curl -fsSL https://plannotator.ai/install.sh \ | bash -s -- --minimal` |
| Claude Code | /plugin marketplace add backnotprop/plannotator, then /plugin install plannotator@plannotator | |
| OpenCode | Add "plugin": ["@plannotator/opencode@latest"] to opencode.json | |
| Pi | pi install npm:@plannotator/pi-extension | |
| Herdr Annotate | herdr plugin install plannotator/herdr-annotate | |
| Plannotator TUI | brew install plannotator/tap/plannotator-tui |
# 1. Install script (macOS / Linux)
curl -fsSL https://plannotator.ai/install.sh | bash
# 2. For Claude Code, add the plugin
/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator
# Uninstall (keep local data / remove everything)
plannotator uninstall
plannotator uninstall --purgeQuick start
- Install with the commands above, then add the plugin to your agent (for example Claude Code)
- When the agent proposes a plan, a review screen opens in the browser. Annotate it, then approve or send the feedback back
- After the work, open the diff with /plannotator-review, add line-level comments and send them back
- Use /plannotator-last for the agent's latest message, or /plannotator-annotate README.md for any file
- Open a GitHub PR or GitLab MR with /plannotator-review <PR URL>; it fetches the data through your authenticated CLI and Git remote
- On Codex, use !plannotator ... or the $plannotator-* skills instead of slash commands
/plannotator-annotate README.md
/plannotator-last
/plannotator-review
/plannotator-review <github-pr-url>
# CLI
plannotator review --patch-file reading.diff
plannotator sessions
plannotator inboxHow it differs from existing tools
| Aspect | Plannotator | Claude Code plan mode | herdr | hunk | GitHub PR review |
|---|---|---|---|---|---|
| Role | Annotated review of plans, diffs and messages | Approve or reject a plan | Run many agents in parallel (terminal multiplexer) | Terminal diff viewer | Code review after you push |
| Interface | Browser (TUI also available) | Inside the terminal | Terminal | Terminal | Browser (GitHub) |
| Annotation granularity | Parts of a plan, individual diff lines | Approve/reject plus text replies | No annotation in the core (integrates via Herdr Annotate) | Shows AI annotations inline | Line comments and reviews |
| Feedback to the agent | Sent back directly | Approval plus text instructions | Runs agents side by side | Mainly a viewing surface | Mostly human-to-human |
| Agents supported | Many (Claude Code, Codex, etc.) | Claude Code only | Multiple agents | Designed to pair with AI agents | Agent-agnostic |
| Price | Free for the local version | Included with Claude Code use | Free (Apache-2.0) | Free (MIT) | Depends on your GitHub plan |
As a rule of thumb: if you only need to approve a plan, plan mode is enough. Plannotator helps when you want to fix one paragraph of a plan, comment on a specific diff line, or handle several agents in one place. Keep human review of the PR on GitHub, and use Plannotator to tighten things in the exchange with the agent before that.
You can also combine it with herdr and hunk. herdr runs several agents in parallel in the terminal, and Plannotator's Herdr Annotate lets you annotate terminal text and Markdown inside herdr (herdr plugin install plannotator/herdr-annotate). Use hunk when you want a quick diff in the terminal, and Plannotator when you want to annotate in the browser and send it back. For GUI options around agents, our T3 Code guide is a useful companion; the README also lists T3 Code's Claude threads as supported.
Caveats and who it suits
- Plans, diffs, annotations, drafts, history and config stay local by default, and the project states it has no usage telemetry or analytics
- However, each app surface checks GitHub for the latest release on load. No content is sent, but GitHub receives a normal request, and the page says there is no opt-out
- Content leaves your machine only through URL fetching (Jina Reader by default), GitHub/GitLab retrieval, Ask AI (sent to your configured provider) and sharing
- Small shares are compressed into the URL fragment and are not encrypted. Large shares and raw HTML are encrypted with AES-256-GCM before upload, and hosted pastes expire after 7 days. Sharing can be disabled with PLANNOTATOR_SHARE=disabled
- Legacy link sharing is kept for compatibility and is moving toward deprecated support; the main direction for team collaboration is the waitlisted Workspaces
- It ships fast (near-daily releases in the v0.28 line), so features and screens change often. Pin and check a version if you use it for work
- It suits people who find prose replies too blunt for Claude Code or Codex output, those who want to polish an agent's work before opening a PR, and those running several agents at once
FAQ
Is Plannotator free?
The local plugin is free and open source, under Apache 2.0 or MIT at your option. Workspaces, the hosted team product, is separate and on a waitlist; the official site lists no pricing.
Do I still need it if I have Claude Code's plan mode?
For simply approving a plan, plan mode is enough. Plannotator adds annotations on specific parts of a plan, line-level diff comments and plan revision diffs in the browser, and sends the feedback back to the agent. You can use both.
Is my plan or diff data sent anywhere?
According to the project, data stays local by default and there is no usage telemetry or analytics. Content leaves your machine only for URL fetching, GitHub/GitLab retrieval, Ask AI and sharing. Each screen also contacts GitHub to check for the latest release, and the page says there is no opt-out for that.
Does it work with Codex?
Yes. On Codex, use !plannotator ... or the $plannotator-* skills instead of slash commands.
Can it review GitHub PRs?
Yes. /plannotator-review <PR URL> opens a GitHub PR or GitLab MR, fetching it through your authenticated CLI and Git remote, with the diff viewer, file tree and annotations.
Can I use it only in the terminal?
Yes. Herdr Annotate runs inside herdr, and Plannotator TUI runs without it (brew install plannotator/tap/plannotator-tui).
Summary
Plannotator is a free local review tool for telling an AI agent exactly what to change in its plans and diffs through annotations. It is finer-grained than plan mode's approve/reject, covers the stage before a GitHub PR review, and pairs with terminal tools such as herdr and hunk. The quickest way to judge it is to install the plugin for your agent and review your next plan with it.
We also cover agent-assisted development setup and operations in software development and AI consulting.
References (primary sources)
株式会社オブライト
Oflight Inc. is a Tokyo-based IT company providing software development, digital signage, web development, network systems, and IoT/AR/VR technology services.
Related free tools (no sign-up, instant results)
Feel free to contact us
Contact Us