Repolode
Submit
backnotprop

backnotprop/plannotator

A local browser-based review surface that lets you annotate agent plans, markdown, HTML and code diffs, then send feedback back to coding agents.

View on GitHubWebsite
Stars
9,509
Forks
711
Open issues
159
Last commit
5 hours ago

What is it?

Plannotator is a local review tool for AI coding agents such as Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, and Pi. It hooks into the agent so that when it proposes a plan or finishes writing code, the work opens in the browser, where you can mark it up with inline annotations and send structured feedback back to the agent.

Besides plan review, it covers annotating markdown files, folders, URLs and rendered HTML artifacts, and reviewing local Git changes or GitHub and GitLab pull and merge requests with a side-by-side diff viewer. Comments on diffs go back to the agent session, and an optional Ask AI feature can answer questions about what you are reviewing.

Sharing is optional. Small markdown shares are encoded in the URL fragment, while larger shares are encrypted client-side before upload to a paste service that can be self-hosted. Settings and plans are stored locally by default, and telemetry is not collected.

Key features

  • 01Inline annotation of plans, markdown, HTML artifacts and web pages
  • 02Side-by-side code review for local changes, GitHub PRs and GitLab MRs
  • 03Feedback from annotations is returned directly to the agent session
  • 04Plan review opens automatically through each agent's hooks
  • 05Optional encrypted link sharing with a self-hostable paste service
  • 06Plans, history and settings are stored locally by default

Use cases

  • Reviewing an agent's implementation plan before it writes code
  • Reviewing local uncommitted changes or a GitHub pull request before committing
  • Annotating generated HTML reports or design documents and sending notes back to the agent
  • Sharing a plan with a teammate for asynchronous feedback

Topics

#ai-agents#code-review#markdown#claude-code#developer-tools#diff#annotation#agents#codex#obsidian

FAQ

What is plannotator?
A local browser-based review surface that lets you annotate agent plans, markdown, HTML and code diffs, then send feedback back to coding agents. Plannotator is a local review tool for AI coding agents such as Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, and Pi. It hooks into the agent so that when it proposes a plan or finishes writing code, the work opens in the browser, where you can mark it up with inline annotations and send structured feedback back to the agent.
Is plannotator free to use? What license does it have?
plannotator is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is plannotator still maintained?
Actively maintained. The last commit to plannotator was on Oct 19, 2026.
What can I use plannotator for?
Reviewing an agent's implementation plan before it writes code Reviewing local uncommitted changes or a GitHub pull request before committing Annotating generated HTML reports or design documents and sending notes back to the agent Sharing a plan with a teammate for asynchronous feedback
Where can I get plannotator?
The source code and installation instructions are on GitHub: https://github.com/backnotprop/plannotator

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects