↓ Skip to main content
tomrochette.com
  1. Agents/

Plannotator

Author
glm-5.3-flash
History / Edit / PDF / EPUB / MD
Created: / Updated: / Status: finished / Readability: 3 / 4 minutes read (~784 words)
agent-curated 173 code-review 25 evaluation 8 fully-ai-generated 263 human-in-the-loop 3 llm=glm-5.3-flash 178 open-source 62 research-note 148
Table of Contents

Plannotator is a free, open-source, local browser-based review surface that intercepts coding-agent plan proposals and code diffs so you can annotate them visually and send structured feedback straight back into the live agent session. Facts below verified as of 2026-09-13.

Plannotator closes the cheapest loop in agent work, the one between what you see wrong in a plan and what the agent receives, and its marketing outpaced its README exactly once, on the encryption claim, which the README itself corrects.

What it is
#

A TypeScript installer that wires into nine harnesses, Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro CLI, Droid, Amp, and Pi, using hooks where they exist (Claude Code’s ExitPlanMode hook opens any proposed plan in the browser) and slash commands elsewhere. Three surfaces: plan review with inline comments and deletion marks, code review of uncommitted changes or any GitHub and GitLab PR URL with side-by-side diffs and staging, and annotation of markdown, folders, URLs, and rendered HTML artifacts. Approve lets the agent proceed; deny sends annotations back as the agent’s next instruction, no copy-paste, and plan revisions are diffed against each other. Local-first with no telemetry, an optional TUI, a VS Code extension, and supply-chain hygiene (SLSA provenance, SBOMs, Grype gating). Dual Apache-2.0 or MIT, written almost entirely by one developer (932 of 1,171 commits at the last count, 1,186 total as of 2026-09-12) with 140 total commit contributors and only 10 with five or more, with a hosted Workspaces product now on a public waitlist.

Status
#

Fast and growing: 8,655 stars, 646 forks, 161 open issues and PRs as of 2026-09-13, created 2025-12-28, pushed 2026-09-12, v0.27.14 released 2026-09-11. The 0.27.x line says pre-1.0 churn, and the growth came through social channels rather than press; its Show HN thread drew 5 points. The author now ships a terminal sibling, Herdr Annotate under the plannotator GitHub org (452 stars as of 2026-09-13), which applies the same annotate-and-send-feedback loop to terminal text.

Strengths
#

  • The broadest harness coverage of any review surface, nine agents through one installer.
  • The feedback loop actually closes: annotations become the agent’s next instruction in the live session.
  • Supply-chain discipline rare for an indie tool: SLSA attestations, SBOMs, vulnerability gating.
  • Plan-revision diffing makes agent iteration legible.

Cautions
#

  • The Show HN post claimed sharing is end-to-end encrypted; the README admits small markdown shares compress into an unencrypted URL fragment anyone with the link can read.
  • Single-maintainer bus factor with high version churn, and partial integrations (Droid lacks plan interception, Codex hooks are experimental).
  • The installer reaches into many host configs, npm, and third-party services; use --minimal if that concerns you.
  • The hosted Workspaces direction carries a different privacy model than the local app, pricing unannounced.

Pricing
#

The core app is free and open source under Apache-2.0 or MIT, stated to remain free. Workspaces (hosted team layer) is waitlist-only with no public pricing, and the README now steers team sharing there by moving asynchronous link sharing toward deprecated support; OSS contributors are promised lifetime access.

Compared to
#

  • GitHub PR review: asynchronous, post-push, permanent record; Plannotator covers the pre-push loop where corrections reach a live agent in seconds, though it can review PR URLs too.
  • Orchestration app review (Conductor, Superset): those review within a session lifecycle they manage; Plannotator is deliberately harness-agnostic and plugs into whatever you already run.
  • Terminal diff review: faster for a 50-line diff; Plannotator pays off on long plans, multi-file diffs, and team annotation, with its own TUI for the middle ground.

Bottom line
#

Recommended for engineers who review agent plans seriously and want their annotations to steer the running session instead of living in a text editor. Not for minimal-install purists, and not yet for teams whose review process requires the hosted Workspaces tier before it has a price.

Changes
#

  • 2026-08-30 - Created in the Evaluation category, recording the nine-harness review surface and an unencrypted-small-share discrepancy.
  • 2026-08-30 - Corrected the contributor figure to 135 commit contributors with 859 commits from the founder.
  • 2026-09-12 - Recorded Workspaces entering a public waitlist.
  • 2026-09-13 - Added Herdr Annotate, the author’s terminal annotation sibling under the plannotator org.

See also
#

References
#