backnotprop / plannotator

Plannotator Interactive Plan & Code Review for AI Coding Agents. Mark up and refine your plans or code diffs using a visual UI, share for team collaboration, and seamlessly integrate with **Claude Code**, **OpenCode**, **Pi**, and **Codex**. **Plan Mode Demos:** Claude Code Watch Demo OpenCode Watch Demo **New:** Code Review Features Visual Plan Review Built-in hook Approve or deny agent plans with inline annotations Plan Diff Automatic See what changed when the agent revises a plan Code Review /plannotator-review Review git diffs or GitHub PRs with line-level annotations Annotate Any File /plannotator-annotate Annotate any markdown file and send feedback to your agent Annotate Last Message /plannotator-last Annotate the agent's last response and send structured feedback Sharing Plans Plannotator lets you privately share plans, annotations, and feedback with colleagues. For example, a colleague can annotate a shared plan, and you can import their feedback to send directly back to the coding agent. **Small plans** are encoded entirely in the URL hash. No server involved, nothing stored anywhere. **Large plans** use a short link service with **end-to-end encryption**. Your plan is encrypted with AES-256-GCM in your browser before upload. The server stores only ciphertext it cannot read. The decryption key lives only in the URL you share. Pastes auto-delete after 7 days. • Zero-knowledge storage, similar to PrivateBin • Fully open source and **self-hostable** (see docs) Install • Claude Code • OpenCode • Pi • Codex Install for Claude Code **Install the command:** **macOS / Linux / WSL:** **Windows PowerShell:** **Then in Claude Code:** See apps/hook/README.md for detailed installation instructions including a approach. --- Install for OpenCode Add to your : **Run the install script** to get : **Windows:** This also clears any cached plugin versions. Then restart OpenCode. --- Install for Pi Then start Pi with to enter plan mode, or toggle it during a session with . See apps/pi-extension/README.md for full usage details, commands, and flags. --- Install for Codex **Install the command:** **macOS / Linux / WSL:** **Windows PowerShell:** **Then in Codex — feedback flows back into the agent loop automatically:** Plan mode is not yet supported. See apps/codex/README.md for details. --- How It Works When your AI agent finishes planning, Plannotator: • Opens the Plannotator UI in your browser • Lets you annotate the plan visually (delete, insert, replace, comment) • **Approve** → Agent proceeds with implementation • **Request changes** → Your annotations are sent back as structured feedback (Similar flow for code review, except you can also comment on specific lines of code diffs) --- License Copyright 2025-2026 backnotprop This project is licensed under either of • Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0) • MIT license (http://opensource.org/licenses/MIT) at your option. Contribution Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.