plannotator
Annotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click.
- 9.6k stars
- 718 forks
- 126 open issues
- Language: TypeScript
- License: Apache-2.0
- updated
Install
git clone https://github.com/backnotprop/plannotator- Clone the repository.
- Follow the README for installation and usage instructions.
Editor's note
Plannotator is a browser-based review interface for AI coding agent plans and code diffs, supporting Claude Code, Copilot CLI, Gemini CLI, OpenCode, Codex, Pi, Droid, and Amp. It installs into Claude Code as a plugin via the marketplace and adds a built-in hook that automatically opens agent plans in the browser during plan mode, where reviewers can approve or deny proposals, add inline annotations, and consult an Ask AI side chat. Slash commands handle additional workflows: `/plannotator-review` renders git diffs or GitHub pull requests with annotation support, and `/plannotator-annotate` opens any markdown file, folder, or URL for annotated feedback that is sent back to the agent in one click. Team collaboration works through shareable encrypted links where small plans encode entirely in the URL hash, while larger plans use AES-256-GCM zero-knowledge storage with auto-deletion after seven days. The tool is self-hostable and ships with SHA256 verification plus SLSA provenance support from version 0.17.2 onward. It primarily benefits developers and teams who want human review checkpoints built into agentic coding workflows.
10 items in this repository
Guard against breaking the @pierre/diffs integration in Plannotator's code review UI. Use this skill whenever modifying DiffViewer.tsx, upgrading the @pierre/diffs package, changing unsafeCSS injection, adding new props to FileDiff, or touching shadow DOM selectors or CSS variables that cross into Pierre's shadow boundary. Also trigger when someone asks "will this break the diff viewer", "is this safe to change", or when reviewing PRs that touch the review-editor package.
Open Plannotator's annotation UI for a markdown file, converted HTML file, URL, or folder and then respond to the returned annotations.
Open Plannotator on the latest rendered assistant message and use the returned annotations to revise that message or continue.
Open Plannotator's browser-based code review UI for the current worktree or a pull request URL, then act on the feedback that comes back.
Turn an idea or objective into a goal package for /goal. Interviews the user, builds a reviewed fact sheet via Plannotator, then explores the codebase to produce an execution plan.
Prepare and execute a Plannotator release — draft release notes with full contributor credit, bump versions across all package files, build in dependency order, and kick off the tag-driven release pipeline. Use this skill whenever the user mentions preparing a release, bumping versions, writing release notes, tagging a release, or publishing. Also trigger when the user says things like "let's ship", "prep a release", "what's changed since last release", or "time to cut a new version".
Review Renovate bot PRs that update GitHub Actions dependencies. Verifies supply chain integrity by checking pinned commit SHAs against upstream tagged releases, reviews changelogs for breaking changes, and confirms compatibility with existing workflow configurations. Use when a Renovate PR updates GitHub Actions in .github/workflows/.
Audit and update npm/Bun dependencies with supply chain integrity checks — verifies maintainers, publish age, tarball diffs, and provenance before bumping. Defers risky packages to ~/.supply-chain/notes/.
Tools overview
What people ask about plannotator
What is backnotprop/plannotator?
backnotprop/plannotator is tools for the Claude AI ecosystem. Annotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click. It has 9.6k GitHub stars and its last recorded update is dated 2026-10-23.
How do I install plannotator?
You can install plannotator by cloning the repository (https://github.com/backnotprop/plannotator) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is backnotprop/plannotator safe to use?
Our security agent has analyzed backnotprop/plannotator and assigned a Trust Score of 97/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.
Who maintains backnotprop/plannotator?
backnotprop/plannotator is maintained by backnotprop. The last recorded GitHub activity is dated 2026-10-23, with 126 open issues.
Are there alternatives to plannotator?
Yes. On ClaudeWave you can browse similar tools at /categories/tools, sorted by popularity or recent activity.