Plannotator plugin
A local browser UI to annotate agent plans and review diffs, then send the feedback back to the agent
- 9,769 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- Installs a binary and hooks into agent configs
- Reads project diffs and files and runs a local server
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/plannotatorDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Installs a binary and hooks into agent configs
- Reads project diffs and files and runs a local server
This is third-party code. Review the repository files before installing.
What it does
Plannotator hooks into the agent through hooks and commands. When the agent writes a plan in plan mode, it opens in the browser, where you highlight passages, comment and send feedback to the agent. /plannotator-review shows uncommitted changes, GitHub PRs or GitLab MRs as a diff with line comments. /plannotator-annotate marks up Markdown, a folder, HTML or a URL, and /plannotator-last annotates the agent's latest reply. Data stays local, with encrypted share links for teammates.
Who it is for. For developers who review agent plans and code before letting changes through.
Good fit when
- You want to fix an agent plan with pinpoint comments instead of a long message
- You need to review the agent's diff or a PR and send notes back to the session
- You want a teammate to annotate a plan and pass their notes to the agent
Not a fit when
- You work on a remote server without a browser or port forwarding
- Regular review in the GitHub UI is enough
Example request
/plannotator-review https://github.com/org/repo/pull/42Limitations
Each UI surface checks GitHub for a new release on load, with no opt-out. URL annotation goes through Jina Reader by default, and AI features send context to your configured provider. PR review needs an authenticated GitHub or GitLab CLI. Features vary per agent; Droid has no plan interception.
How to disable. Run plannotator uninstall to remove hooks, skills and commands while keeping local plans and history. Add --purge to delete data too.
FAQ
Which agents are supported?
Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp and Pi. The installer detects them and configures hooks and commands for each.
Are my plans sent to a server?
No, everything is local by default. Content leaves only for link sharing, URL annotation and AI requests.
Discussion
No questions or reviews yet.
Related
PluginsCrit opens a coding agent's plans, diffs and running apps in a browser: click a line, leave a comment and the agent receives it
A Claude Code and Codex plugin with skills for code research, tests, refactoring and independent review of finished changes
A code-review CLI and plugin for agents: reads a git diff and writes line-level comments with context
Codely team skills that run agent work in phases: a plan in a file or GitHub issues, review after each phase and a clean commit
The /improve skill: a strong model audits a repository and writes self-contained fix plans, and you hand the execution to a cheaper model
A Test Double plugin for Claude Code and Codex: planning, code review, bug investigation and documentation by specialist agents
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Repository stars | Main difference |
|---|---|---|---|
| Plannotator (this entry) | no | 9,769 | |
| difit | no | 3,300 | a CLI that opens a local git diff in the browser like GitHub's Files |
| Lavish Editor (lavish-axi) | no | 4,356 | the agent builds a plan or comparison as an HTML page |
| Agentation | no | 5,157 | annotation toolbar for React pages |
README in short
The README covers three flows: document and plan annotation, code review and HTML annotation. It lists annotate and review commands plus CLI commands for sessions and the decision archive. It details when data leaves the machine and how compressed and encrypted share links work. A single installer covers macOS, Linux and Windows with a per-agent follow-up step. Dual MIT or Apache-2.0 license.