This is an early release preview. You may encounter bugs.
Plannotator logo
Unclaimed

Tool coding

Plannotator

Annotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click.

B 78/100 GitHub score ? This grade is derived from GitHub signals, not user votes. Open for the full breakdown.
Discussion

01 / Summary

About Plannotator.

Plannotator is a local, browser-based review surface for AI coding agents, covering Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp and Pi. It hooks into each agent through its hooks, plugins, skills or slash commands. When the agent proposes a plan, writes HTML, or finishes writing code, the work opens in the browser, where you mark it up, comment, and send the feedback back to the agent to act on.

Plan review needs no command: it is wired into each harness's plan mode, so a markdown review surface opens whenever the agent creates a plan. Annotation also works on any markdown file, a folder of files, a fetched URL, an HTML file rendered as-is, or the agent's last message. Code review covers uncommitted local changes, GitHub pull requests, GitLab merge requests, GitButler workspaces, Jujutsu, Perforce and static diffs, with comments and code suggestions on the diff returned to the agent. Built-in AI can answer questions about what you are reviewing or run review agents that post comments to the diff.

Plans, diffs, annotations, drafts, history and configuration stay local, and Plannotator collects no usage telemetry. Content leaves the machine only for features that need it: URL annotation fetches the page, GitHub and GitLab review use the authenticated CLI, Ask AI sends context to the configured provider, and sharing sends the link. Small markdown shares are compressed into the URL fragment, while large markdown and raw HTML shares are encrypted with AES-256-GCM before upload to a self-hostable paste service that stores only ciphertext. Workspaces, a separate hosted product, is the main path for team sharing.

Herdr Annotate brings the same review flow to the terminal inside Herdr, annotating terminal text, markdown documents and agent replies, and a standalone terminal interface runs the document review without it. Annotations from terminal and browser reviews share one data store.

  • Plan review: plans open in a markdown review surface automatically through each harness's plan-mode hooks, and the feedback returns to the agent
  • Document annotation: markdown files, folders, fetched URLs, rendered HTML artifacts and the agent's last message
  • Code review: local uncommitted changes, GitHub pull requests, GitLab merge requests, GitButler workspaces, Jujutsu, Perforce and static diffs, with comments and suggested code
  • AI assistance: ask questions about the material under review, or launch review agents that post comments to the diff
  • Agent coverage: Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro CLI, Droid, Amp and Pi, each wired through its own hooks, plugin, skills or commands
  • Sessions and archive: list and reopen active review sessions, and browse saved plan decisions read-only
  • Link sharing: compressed URL-fragment shares for small documents and AES-256-GCM encrypted short links for large ones, through a self-hostable paste service
  • Terminal review: Herdr Annotate and a standalone terminal interface annotate terminal text, documents and agent replies
  • Vim controls: an optional keyboard profile that moves through rendered blocks and semantic targets, with selection and annotation actions
  • Local-first privacy: no telemetry, local storage for plans and reviews, and a switch to turn off the remote Git check
  • Release verification: SHA256 sidecars, SLSA provenance attestations and a CycloneDX SBOM attestation on released binaries

02 / Discussion CREDIBILITY-GATED

Discussion

Reading is open to everyone. Posting and voting need a verified identity or a GitHub grade of B or higher.

  • No discussions yet.

04 / Build

Build with Plannotator.

Browse the catalog for frameworks, tools, and harnesses, each scored on real GitHub credibility.

Get Plannotator →

Browse the catalog