Skip to main content
Plannotator is an open-source, local feedback tool for coding agents. It opens plans, Markdown, HTML, local code changes, pull requests, and merge requests in a visual interface, then returns your annotations and feedback to the agent. The plannotator binary runs a temporary server on your computer and opens the session in your browser. Plannotator supports Claude Code, Codex, OpenCode, Copilot CLI, Gemini CLI, Pi, Amp, Droid, and Kiro CLI through host-specific hooks, plugins, commands, or skills.

Install Plannotator

Install, update, or remove the binary and connect your coding agent.

Self-host share services

Deploy the deprecated OSS share portal and paste service when compatibility requires them.

Install agent skills

Compare core and extra skills, choose specific skills and hosts, and manage updates.

Annotate a plan or document

Open Markdown, mark what should change, and send feedback to your coding agent.

Review code

Review local code changes and return line-specific feedback to your coding agent.

Share a plan or PRD

Use the deprecated OSS sharing flow, retained for compatibility, and import returned annotations.

Choose your agent

Set up Claude Code, Codex, OpenCode, Copilot CLI, or another supported agent.

Open Plannotator

Start it from your coding agent or run it directly.

Plans and documents

Use Plannotator to select text, request deletions, attach comments or images, edit Markdown, and send structured feedback. Plan reviews can also show what changed after the agent revises the plan.

Plan review

Review a plan before the agent starts implementation.

Annotate a document

Annotate documents, plain-text config and data files, URLs, and folders.

Open HTML

Annotate rendered local HTML and understand its security boundary.

Review code

plannotator review opens local Git, Jujutsu, GitButler, or Perforce changes. You can also pass a GitHub pull request or GitLab merge request URL. Plannotator shows the diff, accepts line comments and suggestions, and returns your feedback to the agent session.

Review local changes

Review committed branch work, working-tree changes, and untracked files where the current VCS supports them.

Review a pull request or merge request

Open GitHub and GitLab reviews from their URLs and choose local or API-only review.

Where data goes

Normal local sessions bind to 127.0.0.1. Plannotator stores plans, history, drafts, configuration, and session records under its data directory. This directory is ~/.plannotator by default. Plannotator uses an absolute XDG_DATA_HOME only when ~/.plannotator does not exist.
Remote mode binds to 0.0.0.0. The review UI and local APIs do not add user authentication. Use SSH port forwarding or a trusted private network.
Plannotator OSS does not send usage telemetry or analytics. Its app surfaces check GitHub automatically for the latest release, and a local Git review can contact its configured origin. Optional features can contact URL, provider, AI, sharing, or hosted services. See Privacy and data flow for the details. Plannotator is dual-licensed under MIT or Apache 2.0. Source code, releases, and issue tracking are in backnotprop/plannotator. Last verified on July 31, 2026, using Plannotator product commit 7cd023c. Maintained by the Plannotator project.
Last modified on August 13, 2026