Plannotator
Plannotator is a local, open-source plugin for reviewing coding-agent plans and code diffs. Annotate plans, inspect diffs, share feedback, and send structured review notes back to the agent.
Visit backnotprop/plannotatorOverview
Plannotator provides a review workspace for coding agents. It intercepts plan approval, lets users annotate proposed plans and agent-written code diffs, and returns structured feedback to the agent. It runs locally and integrates with supported agents and editors.
Key Features
- Automatic plan review that hooks into an agent's plan approval step.
- Inline annotations on plans, including comments, deletion marks, and replacements.
- PR-style code review for local diffs and GitHub or GitLab pull requests, with side-by-side or unified views and line-level suggestions.
- Version history with diffs between plan revisions and draft auto-save that survives server crashes and restarts.
- Local review data by default, with no usage telemetry or analytics.
- Integrations for VS Code, Obsidian, Bear, GitHub PRs, and multiple coding agents.
Use Cases
- Review an agent's proposed plan before it executes and approve or deny it with structured feedback.
- Review uncommitted agent-written code in a diff viewer and stage or unstage files before committing.
- Annotate markdown files, specs, folders, URLs, or an agent's last message and send feedback back.
- Share review links with teammates using URL fragments or encrypted short links.
Getting Started
- Run the provided shell install script.
- In Claude Code, add the plugin marketplace and install the Plannotator plugin.
- Restart Claude Code to activate hooks.
Deployment & Requirements
- Runs locally.
- Integrates with supported agents such as Claude Code, OpenCode, Pi, Codex, and VS Code.
- Works with any agent that supports plan mode.
Before You Adopt
- License: Apache-2.0. Review its terms before using, modifying, or distributing the project.
- Review data stays local by default, and the project states there is no usage telemetry or analytics.
- Plannotator Workspaces, the hosted team layer, is listed as a waitlist offering.
- Integration behavior depends on the host agent: hooks are available only where supported, with slash commands used where they fit.