Plannotator v0.21.4

Plannotator is an open-source platform designed to review and validate plans and code generated by AI coding agents.

The platform provides a centralized interface where developers can:

  • Review AI-generated plans

  • Annotate proposed actions

  • Approve or reject tasks

  • Inspect code changes

  • Provide structured feedback

  • Improve agent outputs

  • Maintain human oversight

Rather than replacing developers, Plannotator aims to keep humans involved in critical decision-making during AI-assisted development.

As AI coding agents become increasingly capable, developers face a growing challenge: ensuring that AI-generated plans and code changes align with project requirements before they are executed. Plannotator addresses this problem by acting as a review layer between developers and AI coding agents.

Instead of generating code itself, Plannotator focuses on making AI-driven development more transparent and controllable. It allows teams to review, annotate, approve, reject, and refine agent-generated plans and code changes before they affect a project.

Download Plannotator v0.21.4 - Software Mirrors

Plannotator v0.21.4 for Windows

plannotator-paste-win32-arm64.exe | 106.86 MB

plannotator-paste-win32-x64.exe | 110.08 MB

plannotator-win32-arm64.exe | 159.67 MB

plannotator-win32-x64.exe | 162.88 MB

Plannotator v0.21.4 for macOS

plannotator-darwin-arm64 | 111.47 MB

plannotator-darwin-x64 | 115.88 MB

plannotator-paste-darwin-arm64 | 58.24 MB

plannotator-paste-darwin-x64 | 63.07 MB

Plannotator v0.21.4 for Linux

plannotator-linux-arm64 | 146.98 MB

plannotator-linux-x64 | 147.51 MB

plannotator-paste-linux-arm64 | 94.17 MB

plannotator-paste-linux-x64 | 94.7 MB

Plannotator v0.21.4 Release Notes:

Follow @plannotator on X for updates
Missed recent releases?
  • v0.21.3: File comments in code review, unified click-to-highlight comments, VS Code clipboard/keyboard bridge, Codex Ask AI on app-server transport, CLI subcommand help
  • v0.21.2: Custom reviews as Agent Skills, Cursor + OpenCode review engines, whole-file/general findings, deleted-annotation fix, Codex Ask AI outside git repos
  • v0.21.1: Annotate-last blank-page fix on multi-message sessions
  • v0.21.0: Direct document editing in annotate mode, live git-status file tree, in-app agent terminal, open files in external apps, HTML renders as HTML
  • v0.20.3: Annotations no longer lost when clicking away, off-screen indicator for open comments
  • v0.20.2: Pierre CodeView all-files review, large-PR pipeline and instant-open checkout, unified agent engine selection, Pi programmatic plan mode
  • v0.20.1: Pi extension install hotfix (pinned @pierre/diffs after a broken upstream release)
  • v0.20.0: Multi-repo workspace reviews, semantic diff overview, UI 2.0 themes and plan look chooser, leaner single-source skill install
  • v0.19.27: Kiro CLI integration, Glimpse native window, annotate-last message picker
  • v0.19.26: Amp plugin production fixes, Mermaid rendering fix, Settings flicker fix, update notification toast and shimmer
  • v0.19.24: Amp integration, configurable data directory, Auto Mode permission option, Pi plan approval fix

What's New in v0.21.4

This release adds Markdown math rendering and continues the code-review pass from v0.21.2 and v0.21.3. The PR review experience is consolidated into a single Overview panel where the description and individual comments are now annotatable, and the "Copy agent instructions" onboarding reaches code review at parity with plan mode. Five PRs land, including one from returning contributor @ishowman.

Markdown Math Rendering

Plans, annotated documents, and PR content now render LaTeX math. Inline math written as $…$ or \(…\) and display math written as $$…$$ or \[…\] typeset through KaTeX, with the fonts bundled into the app so equations render offline. Rendered formulas are also first-class annotation targets: you can drag-select across prose and a formula together, or redline a whole equation, and the selection is captured like any other annotation. Because the same renderer handles arbitrary plan text and untrusted PR descriptions, it is deliberate about what counts as math. A stray or unterminated $$ (or an informal amount like $$100k) no longer runs on and swallows the rest of a document — an unclosed delimiter is treated as ordinary text, so headings and paragraphs below it keep their structure and stay annotatable. Dollar amounts in prose such as $5-$10, $50,000-$100,000, or $5/mo … $10/mo are left as literal text rather than being mistaken for inline math. PR #878 closing #831, by @ishowman — requested by @XxxXMil.

PR Overview Panel

Reviewing a pull request used to mean three separate dock tabs — Summary, Comments, and Checks — behind three header buttons. They are now one PR Overview panel: the description and checks stack on the left, comments fill the right, and checks collapse into a progressive-disclosure section with a colored progress label. The comments view gained author avatars, a single-row toolbar with search and filters, a "hide bots" toggle, and background refresh so the discussion and check state stay current while you review. The description and comments are also annotatable. Select text in the PR description and leave a comment, or click "Annotate" on any comment card to attach a note to the whole comment. These notes show in the Annotations sidebar under their own groups, count toward the review, and ship to the agent — with the full comment body quoted alongside your note, since the agent can't see the PR discussion on its own. Prose notes stay bound to the PR they were made on: switching to another PR in place hides them from view and export rather than carrying them onto the new PR, and switching back brings them right back. The description renders through the full shared block renderer, so tables, callouts, code, and embedded media (images, , and ) all display inline. PR #981, by @backnotprop.

Copy Agent Instructions in Code Review

Plan mode has a "Copy agent instructions" action that hands an agent the exact clipboard contract for posting annotations back into Plannotator. That onboarding now exists in code review too, at parity with plan mode: the review header menu offers "Agent Instructions" in a live session, and the copied payload documents how to read the changeset, derive line numbers from the diff, and POST line-, file-, and general-scoped comments (including code suggestions). The backend already accepted these; this closes the missing on-ramp. PR #983, by @backnotprop — suggested by @hakunin on X.

Additional Changes

  • Immediate feedback when launching a review agent — clicking Run in Review Agents now shows a pending launch row and a "Starting" state right away, surfaces server-side launch failures instead of silently clearing the request, and hands off cleanly to the real job once it starts. PR #980, by @backnotprop.
  • Annotation count badge in the plan and annotate header — the annotations toggle in the shared plan/annotate header now shows a numeric count badge, matching the code-review header. PR #979, by @backnotprop.
  • Sturdier media and delimiter parsing — the shared markdown parser no longer lets an unclosed / tag or a multi-line swallow or garble the rest of a document, and / and responsive now render correctly. This hardens the same renderer the math and PR Overview work rely on.

Install / Update

macOS / Linux:
bash
curl -fsSL https://plannotator.ai/install.sh | bash
Windows:
powershell
irm https://plannotator.ai/install.ps1 | iex
Extra skills (compound, setup-goal, visual-explainer), opt-in:
bash
npx skills add backnotprop/plannotator/apps/skills/extra
Claude Code Plugin: Run /plugin in Claude Code, find plannotator, and click "Update now". OpenCode: Clear cache and restart:
bash
rm -rf ~/.bun/install/cache/@plannotator
Then in opencode.json:
json
{
  "plugin": ["@plannotator/opencode@latest"]
}
Pi: Install or update the extension:
bash
pi install npm:@plannotator/pi-extension
Droid: Install via the plugin marketplace:

droid plugin marketplace add backnotprop/plannotator
droid plugin install plannotator@plannotator
Amp: Install the CLI first, then copy the plugin:
bash
mkdir -p ~/.config/amp/plugins
curl -fsSL https://raw.githubusercontent.com/backnotprop/plannotator/main/apps/amp-plugin/plannotator.ts \
  -o ~/.config/amp/plugins/plannotator.ts
Kiro CLI: The installer auto-detects Kiro and installs skills automatically. After installing the CLI, launch with:
bash
kiro-cli chat --agent plannotator
Upgrading from before v0.20.0? Read the v0.20.0 release notes first; that release changed how skills install.

What's Changed

  • feat(ui): render markdown math by @ishowman in #878
  • feat(review): PR Overview panel + description/comment annotations + media by @backnotprop in #981
  • feat(review): add "Copy agent instructions" for external review comments by @backnotprop in #983
  • fix(review): show pending agent job launches by @backnotprop in #980
  • feat(annotate): show annotation count badge in plan/annotate header by @backnotprop in #979
  • fix(ui): stop unclosed / from swallowing the document by @backnotprop
  • fix(review): scope PR description/comment notes to their PR by @backnotprop
  • fix(ui): keep stray/unclosed math delimiters and dollar amounts from mangling text by @backnotprop

Contributors

@ishowman built Markdown math rendering (#878), picking up the feature request in #831 and implementing inline and display math with KaTeX, including selectable, annotatable formulas. Thanks also to the community members whose requests shaped this release:
  • @XxxXMil requested Markdown math formula rendering (#831), delivered in #878.
  • @hakunin suggested (on X) bringing the "Copy agent instructions" onboarding to code review, delivered in #983.
Full Changelog: https://github.com/backnotprop/plannotator/compare/v0.21.3...v0.21.4

Key Features of Plannotator

Plan Review System

One of Plannotator's core capabilities is reviewing plans generated by AI agents before execution.

Developers can examine:

  • Proposed tasks

  • Implementation strategies

  • Agent reasoning

  • Planned file modifications

  • Workflow sequences

This visibility helps reduce unintended changes and costly mistakes.

Annotation Tools

The platform allows users to add comments, notes, and guidance directly to AI-generated plans.

These annotations can be used to:

  • Clarify requirements

  • Correct misunderstandings

  • Provide context

  • Guide future agent actions

AI Code Review

Plannotator extends the review process beyond planning by supporting inspection of generated code.

Developers can:

  • Review modifications

  • Analyze diffs

  • Leave comments

  • Request revisions

  • Validate implementation details

This workflow resembles modern pull-request review systems.

Human-in-the-Loop Workflows

A major design goal is ensuring that AI actions remain subject to human approval.

Organizations can establish review processes where important actions require validation before execution.

Open Source Foundation

Plannotator is open source, allowing teams to inspect, modify, and self-host the platform according to their needs.

This transparency is particularly valuable for organizations adopting AI-assisted software development.

User Experience

The interface is designed around review workflows rather than direct code generation.

Instead of interacting with a chatbot, users primarily:

  1. Receive agent-generated plans

  2. Review proposed actions

  3. Add feedback

  4. Approve or reject changes

  5. Monitor execution results

The workflow feels familiar to developers accustomed to pull requests, code reviews, and project planning tools.

Productivity Benefits

As AI coding tools become more autonomous, review processes become increasingly important.

Plannotator helps organizations:

  • Reduce risky AI actions

  • Improve code quality

  • Increase accountability

  • Preserve architectural consistency

  • Encourage collaboration between developers and AI agents

For teams adopting AI-driven development, these safeguards can be as valuable as the coding agents themselves.

Collaboration Features

The platform supports collaborative review workflows where multiple team members can participate in evaluating AI-generated outputs.

This allows:

  • Peer review

  • Team approval processes

  • Shared annotations

  • Collective decision-making

Such features are especially useful for larger engineering teams.

Performance

Because Plannotator focuses on workflow management and review rather than model inference, performance largely depends on the connected AI agents and integrations.

The platform itself is lightweight and primarily serves as an orchestration and review layer.

Open Source Advantages

Being open source provides several benefits:

  • Transparent development

  • Self-hosting capabilities

  • Custom integrations

  • Community contributions

  • Vendor independence

Organizations concerned about compliance, security, or proprietary workflows may find these advantages particularly appealing.

Limitations

Plannotator is designed as a companion tool rather than a complete AI development platform.

Common limitations include:

  • Requires external AI coding agents

  • Best suited for teams already using AI-assisted development

  • Smaller ecosystem than mature developer platforms

  • Additional review steps may slow rapid prototyping

  • Some users may prefer fully autonomous workflows

The software delivers the most value in environments where oversight and quality control are priorities.

Pros

  • Improves transparency of AI-generated plans

  • Supports structured review workflows

  • Human-in-the-loop design

  • Useful annotation system

  • Open source

  • Self-hosting support

  • Familiar review experience for developers

  • Helps reduce AI-generated mistakes

Cons

  • Not a standalone coding agent

  • Requires integration with AI development tools

  • Smaller community than established developer platforms

  • Adds review overhead to workflows

  • Best suited for teams rather than casual users

Who Should Use Plannotator?

Plannotator is ideal for:

  • Software development teams

  • Engineering managers

  • AI-assisted development workflows

  • Organizations adopting coding agents

  • Open-source projects

  • Teams prioritizing code quality and governance

It is particularly valuable for environments where AI-generated code requires oversight before reaching production systems.

Plannotator fills an increasingly important role in the AI development ecosystem by providing visibility and control over AI-generated plans and code changes. Its focus on human oversight, structured reviews, and collaborative workflows makes it a useful companion for modern coding agents. While it is not a replacement for AI coding tools themselves, it offers a practical solution for teams seeking greater confidence and accountability in AI-assisted software development.

Plannotator v0.21.4
Free
Software Informations:
Developer:

Operating System:
Windows / macOS / Linux
Date Added:
2026-07-01T23:01:37.022Z
Categories:

Post a Comment/Report Broken Link: