Mindket

plannotator

Newversion 1 · updated
Star10.5k

Overview

Opens your AI coding agent's plans, specs and code changes in a browser so you can annotate or comment on them and send the feedback straight back to the agent.

plannotator is an open-source project on GitHub in the Developer category, listed by Mindket. It is free. This is version 1, last updated on . Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip.

At a glance

Runs in
  • Claude Code and Codex
  • Copilot CLI and Gemini CLI
  • OpenCode, Kiro, Droid, Amp and Pi
  • Your browser, as the place where the review happens

Platform

Claude CodeCoding agent
CodexCoding agent
CopilotAI chat
Gemini CLICoding agent
OpenCodeCoding agent

About

What it is

Plannotator is a review page that runs locally in your browser for work done by AI coding agents. It attaches to your agent using hooks and commands. When the agent offers a plan, produces HTML or finishes code, the work opens in the browser, where you mark it up and send your comments back.

Who it suits

It suits developers who work with coding agents and want to read, correct and approve the agent's output before anything is built or merged. The project also lets you share work with your team.

IndustryWho uses itHow they use itExample
Software developmentDevelopers using coding agentsAnnotate a plan or spec before the agent starts buildingComments on a plan that the agent then acts on
Code reviewReviewersComment on local changes or remote pull requests and suggest codeReview comments on a diff that go back to the agent
Team deliveryTeams running several agentsManage multi-agent work through Plannotator InboxOne place to follow what several agents are doing

Anyone who does not use an AI coding agent can skip it.

Where to use it

  • Claude Code and Codex
  • Copilot CLI and Gemini CLI
  • OpenCode, Kiro, Droid, Amp and Pi
  • Your browser, as the place where the review happens
Use caseWhoWhat they get back
Plan reviewDevelopersA marked-up plan or spec the agent can act on
Code reviewDevelopers and reviewersComments and suggested code on a diff or pull request, sent to the agent
HTML reviewTeamsComments on HTML that the agent produced

How to use it

Work with your agent as usual. When it proposes a plan or finishes a change, the review page opens in your browser. Mark up the text, comment on the diff, then send everything back to the agent with one click.

ToolWhat it does
Markdown ReviewLets you annotate plans, specs and markdown before implementation
Code ReviewLets you review local changes or remote pull requests and comment on diffs
HTML ArtifactsLets you mark up HTML that the agent produces
Plannotator InboxHelps you manage the work of several agents

Example

Your agent proposes a plan for a new feature. You open it in the review page, strike one step, add a note on another, and send your comments back. The agent then revises the plan with them.

For newcomers and experts

If you are new, think of Plannotator as a way to give an AI agent notes the way you would on a shared draft. Start with the next plan your agent writes and add one comment to it.

Under the surface, hooks and commands in each agent open the review page when work is ready, and your comments travel back to that agent as feedback to act on. The same page handles plans, specs, HTML and diffs, so one review habit covers all of them.

  1. The agent proposes a plan or finishes code
  2. The work opens in your browser
  3. You mark it up and comment
  4. You send the feedback with one click
  5. The agent acts on it

Good to know

  • Scope: it is a review surface, so it does not write the code or plans for you.
  • License: Apache-2.0.
  • Cost to run: none named.
  • Data it reaches: the plans, specs, diffs and pull requests your agent produces, shown in your browser, and the comments you send back.
  • Not for: the source names no exclusions, and nothing in this kit runs by itself.

README and files

README

plannotator

Opens your AI coding agent's plans, specs and code changes in a browser so you can annotate or comment on them and send the feedback straight back to the agent.

Made by backnotprop on GitHub. These notes are Mindket's, written from its README; the project's own files and license are in its repository.

About

What it is: Plannotator is a review page that runs locally in your browser for work done by AI coding agents. It attaches to your agent using hooks and commands. When the agent offers a plan, produces HTML or finishes code, the work opens in the browser, where you mark it up and send your comments back.

Who it suits: It suits developers who work with coding agents and want to read, correct and approve the agent's output before anything is built or merged. The project also lets you share work with your team.

Industry | Who uses it | How they use it | Example
Software development | Developers using coding agents | Annotate a plan or spec before the agent starts building | Comments on a plan that the agent then acts on
Code review | Reviewers | Comment on local changes or remote pull requests and suggest code | Review comments on a diff that go back to the agent
Team delivery | Teams running several agents | Manage multi-agent work through Plannotator Inbox | One place to follow what several agents are doing

Anyone who does not use an AI coding agent can skip it.

Where to use it:

  • Claude Code and Codex
  • Copilot CLI and Gemini CLI
  • OpenCode, Kiro, Droid, Amp and Pi
  • Your browser, as the place where the review happens
Use case | Who | What they get back
Plan review | Developers | A marked-up plan or spec the agent can act on
Code review | Developers and reviewers | Comments and suggested code on a diff or pull request, sent to the agent
HTML review | Teams | Comments on HTML that the agent produced

How to use it: Work with your agent as usual. When it proposes a plan or finishes a change, the review page opens in your browser. Mark up the text, comment on the diff, then send everything back to the agent with one click.

Tool | What it does
Markdown Review | Lets you annotate plans, specs and markdown before implementation
Code Review | Lets you review local changes or remote pull requests and comment on diffs
HTML Artifacts | Lets you mark up HTML that the agent produces
Plannotator Inbox | Helps you manage the work of several agents

Example: Your agent proposes a plan for a new feature. You open it in the review page, strike one step, add a note on another, and send your comments back. The agent then revises the plan with them.

For newcomers and experts: If you are new, think of Plannotator as a way to give an AI agent notes the way you would on a shared draft. Start with the next plan your agent writes and add one comment to it.

Under the surface, hooks and commands in each agent open the review page when work is ready, and your comments travel back to that agent as feedback to act on. The same page handles plans, specs, HTML and diffs, so one review habit covers all of them.

The agent proposes a plan or finishes code
The work opens in your browser
You mark it up and comment
You send the feedback with one click
The agent acts on it

Good to know:

  • Scope: it is a review surface, so it does not write the code or plans for you.
  • License: Apache-2.0.
  • Cost to run: none named.
  • Data it reaches: the plans, specs, diffs and pull requests your agent produces, shown in your browser, and the comments you send back.
  • Not for: the source names no exclusions, and nothing in this kit runs by itself.

On GitHub, 14 November 2026

  • Stars: 10,483 (108 that day)
  • Forks: 788
  • Watching: 24
  • Open issues and pull requests: 209
  • Language: TypeScript
  • License: Apache-2.0
  • Topics: agents, claude-code, code-review, codex, obsidian, opencode, pi-mono, plan-mode, skills
  • Trending: #6 repository of the day on GitHub trending (14 November 2026)

Links

Intro videos

Get the code

git clone https://github.com/backnotprop/plannotator.git

Then follow the setup in its README. Nothing in this kit runs by itself.

Files
README.md  5 KB

1 file, 5 KB, downloaded as a zip.

What’s new

  • Version 1 · 2026-11-14

Compare with similar

Listed GitHub projects in the same category that share the most topics with this one.

ProductStarsActivityLanguageLicenseLast change
plannotator This page10,483ActiveTypeScriptApache-2.0
imboShares opencode · codex · claude-code111ActiveRustApache-2.0
code-review-skillShares code-review · codex · claude-code441ActivePythonMIT
Agent SkillsShares skills · codex · claude-code116,705ActiveJavaScriptMIT
BAMAShares skills · codex · claude-code1,619ActiveSwiftMIT
WorktrunkShares agents · codex · claude-code12,134ActiveRust—
Numbers as Mindket last read them, from 2026-11-06 to 2026-11-14. Activity is read from each project’s last change on GitHub: Active within 30 days, Quiet within 180, Stale after that.

Reviews

No ratings yet

Write a review

No reviews yet.

What people say

Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search and on Trendshift. Mindket doesn’t write or check them. Open one to read it where it was posted.

ramozShow HN: Email-like interface to review, decide, and annotate agent workThere is some recent discourse about what a "better" interface for humans managing agents looks like. Email/inboxes have come up, and it's reinforcing the premise of thing i've been building. e.g. - https://x.com/brian_armstrong/status/2119112609223827547 -…7 pointsramozShow HN: Open-source guided code reviewshttps://xcancel.com/plannotator/status/2073845811847512372?s... https://github.com/backnotprop/plannotator Plannotator Code Review works for any local or PR changes, jj, and p4. You can conduct a code review on your own or integrate it with your agents and submit feedbacks to create an automated…4 points · 3 repliesramozShow HN: Code Review Enviornment for the Modern EraPlannotator opens a local diff viewer (git, jj, p4). You annotate lines, tokens, or comment on files, and when you're done they feed straight into your agent session; creating an automated feedback loop. It works on local diffs, commits, branches, worktrees, and GitHub/GitLab PRs. The PR view lets…5 pointsramozShow HN: jj diff review integrated with agentshttps://github.com/backnotprop/plannotator5 pointsramozShow HN: Manual code review and feedback loop for agentsFully oss: https://github.com/backnotprop/plannotator4 pointsramozShow HN: Interactive plan annotation and sharing for Claude CodePlannotator works via hooks and therefore it's fully integrated with the Claude Code planning mode capability. I found myself constantly wanting to annotate verbose plans. I've also wanted to copy and share plans on occasion - gathering others' feedback. So I built this. Sharing is private and was…4 pointsramozShow HN: Code walkthroughs you can send as a fileThis is an agent skill that creates a portable code review file (HTML) for change sets and diffs. https://github.com/plannotator/guides/blob/main/skills/plann... It uses a baked in CDN that I host. Otherwise the size of the file would be pretty big. The diffs are by diffs.com. You can also create…3 pointsramozShow HN: Claude Code Plan Mode Pluginhttps://github.com/backnotprop/plannotator OpenCode as well3 points

Searched

More from Mindket

See all from Mindket

Bonsai-27B-GGUF

lmstudio-community · Kit

A GGUF conversion of the 27B Bonsai model for LM Studio, with a 3.80 GB Q1_0 language file and a 0.93 GB BF16 vision projector. Tested for text, vision and par…

New

Runs DeepSeek-V4.1-Flash-1017 as a 2.9 bits-per-weight EXL3 quantization, a 196 GiB copy for people serving large models on their own hardware. Perplexity stay…

New

MusicGen Small

facebook · Kit

Generates short music clips from a text description or an audio prompt, in the small checkpoint of facebook's MusicGen. It suits developers and music hobbyists…

New

Similar projects

See all in Developer

Agent Skills

addyosmani · Skill

Addy Osmani’s open-source set of engineering skills for AI coding agents. Each skill is a Markdown workflow with steps, checks and exit criteria. The setup not…

New117k

Guizang PPT Skill

op7418 · Skill

Skill that makes single-file HTML slide decks, slide illustrations and platform covers in two visual styles, with a presenter mode for rehearsal. For speakers…

New29.8k

Worktrunk

max-sixty · Kit

A command-line interface for managing Git worktrees. It helps developers switch between branches and manage parallel AI agent tasks efficiently.

New12.1k