A local-first tool providing visual plan annotation and PR-style diff review for AI coding agents like Claude Code, Copilot CLI, and Gemini CLI.
Plannotator is a visual review tool for AI coding agents, addressing the limitations of plain-text interaction during agent plan approval and code review.
Plan Review#
Intercepts the agent's plan approval step via hooks and automatically opens a browser-based visual review interface. Supports inline annotations (delete, insert, replace, comment), automatic plan diff, version history, and version-to-version comparison. Users can Approve to let the agent proceed, or Request Changes to send annotations as structured feedback back to the agent.
Code Review#
Provides a PR-style diff viewer with side-by-side or unified views, file tree navigation, line-level annotations, and code suggestions. Can review local uncommitted changes or remote GitHub/GitLab PRs.
Annotate#
Annotation capability extends to any Markdown, HTML, URL, or folder. Triggered via /plannotator-annotate <target> or /plannotator-last, with support for --gate, --json, and --silent-approve flags.
Sharing & Collaboration#
Small plans are encoded in URL hashes (no server needed); large plans use end-to-end encrypted short links (AES-256-GCM browser-side encryption, server stores only ciphertext — a PrivateBin-like zero-knowledge scheme). Pasted content auto-deletes after 7 days. Colleagues can annotate shared plans and import feedback back to the agent.
Local-First & Reliability#
All plan processing happens locally — plan data never leaves the user's machine. Annotations are auto-saved and survive crashes and restarts.
Architecture#
Monorepo with apps/ and packages/ directories, managed by bun. Frontend built with Astro, primarily TypeScript (86.8%). Each AI agent has a dedicated adapter package (Claude Code, Copilot CLI, Gemini CLI, OpenCode, Pi, Codex). Agent skills described via CLAUDE.md / AGENTS.md. CI/CD via GitHub Actions with Renovate bot for dependency updates.
Supported AI Agents#
Claude Code, GitHub Copilot CLI, Gemini CLI (≥0.36.0), OpenCode, Pi, Codex.
Editor & Note Tool Integrations#
- VS Code: Open plans in editor tabs with diff view and editor annotations (Marketplace publishing status unconfirmed)
- Obsidian: Auto-save plans to vault with frontmatter and tags
- Bear: Save plans with nested tags and project metadata
Installation#
macOS / Linux / WSL:
curl -fsSL https://plannotator.ai/install.sh | bash
Windows PowerShell:
irm https://plannotator.ai/install.ps1 | iex
Claude Code integration:
/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator
Fully self-hostable — see docs directory in the repository.
Current version v0.19.1 (87 releases), 74 contributors. Dual-licensed under Apache-2.0 or MIT since v0.19.0 (previously BSL-1.1).