Plannotator v0.27.7

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.27.7 - Software Mirrors

Plannotator v0.27.7 for Windows

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

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

plannotator-win32-arm64.exe | 143.41 MB

plannotator-win32-x64.exe | 147.12 MB

Plannotator v0.27.7 for macOS

plannotator-darwin-arm64 | 114.13 MB

plannotator-darwin-x64 | 119.17 MB

plannotator-paste-darwin-arm64 | 60.51 MB

plannotator-paste-darwin-x64 | 65.97 MB

Plannotator v0.27.7 for Linux

plannotator-linux-arm64 | 142.54 MB

plannotator-linux-x64 | 143.42 MB

plannotator-paste-linux-arm64 | 89.35 MB

plannotator-paste-linux-x64 | 90.21 MB

Plannotator v0.27.7 for Other

plannotator-0.27.7-release-sbom.cdx.json | 1.6 MB

Plannotator v0.27.7 Release Notes:

Follow @plannotator on X for updates
Missed recent releases?
  • v0.27.6: Live app annotation lands on Pi, one interaction model for HTML pages (same-day patch on v0.27.5)
  • v0.27.5: Annotate your running app, Agent TUI placement, collapsed lockfiles, VS Code theme fix, Pi fixes
  • v0.27.4: Portable Guided Review exports, guides.show share links, guide CLI, favicon switcher, jj Call Flow
  • v0.27.3: Folder watcher freeze fix on large repos, first SBOM-attested release pipeline
  • v0.27.2: Mobile plan and code review, Codex CLI 0.147 fix, folder annotate cold-start, configurable markdown extensions
  • v0.27.1: Open-in-editor launch fix, file headers respect Viewed/Git-add visibility toggles
  • v0.27.0: Call Flow analysis, --tailscale remote reviews, review panel remembers your view, Pi rebuild (breaking command rename), focus-mode shortcut
  • v0.26.8: Placed comment markers on HTML pages, shift-click multi-select, live app annotation
  • v0.26.7: Pinpoint targets any element on HTML pages, smarter hover labels, zero-scan hit testing
  • v0.26.6: Fixed empty environment variables in sandboxed sessions (Bun 1.3.14 builds)
  • v0.26.5: HTML pinpoint element annotations, durable annotate submissions, installer fallback for old git, vim HUD cursor fix
  • v0.26.4: Skill-menu hover jitter fix (same-day patch on v0.26.3)

What's New in v0.27.7

A patch release led by a crash fix for Pi on Windows: a broken provider pipe could take down the entire Pi host mid plan review. Five PRs, three from returning community contributors, plus a new top-level knowledge skill that also powers plannotator.ai/llms.txt.

Pi no longer crashes when a provider pipe breaks

On Windows, opening a plan review from Pi could kill the whole Pi host with an unhandled EPIPE error. The provider child process's stdin pipe broke, nothing was listening for the failure, and the host process died with it. This is fixed as a class, not a symptom. Every provider child process (Pi and the Codex app-server transport) now routes its pipe writes through a shared guard: a broken pipe fails that provider's query cleanly, the provider is marked dead and restartable, and the host keeps running. The regression test reproduces the exact pre-fix crash in a real Node child process. Thanks @Kaelenx for the detailed report and for verifying the fix on the original machine within the hour.
  • #1379 by @backnotprop, closing #1378 reported by @Kaelenx

Call Flow stops failing on normal reviews

Call Flow rejected any analysis producing more than 100 call trees, and languages that emit many small per-function trees (Swift, TypeScript) hit that ceiling on ordinary branch reviews. @sergdort's measurements in #1351 showed a normal 161-file review producing 470 valid trees, computed in under 800ms, rejected whole. The tree cap is now 2,000, and a result that still exceeds it degrades instead of failing: the first 2,000 trees render and a visible warning in the panel says how many were truncated. The caps that guard against genuinely unbounded output (total nodes, tree depth, raw length) still reject exactly as before.
  • #1370 by @ashish921998, closing #1351 reported by @sergdort

jj reviews start from where your work actually began

The jj Line of work view always diffed against trunk(). If your work branched off a staging or development line instead, the review included every commit from that line too, burying your changes in unrelated ones. Plannotator now asks jj where the current line of work forked from shared history and starts the review there. The base is named by its remote bookmark when one exists, then its local bookmark, then the commit ID, and jj's internal push-* bookmarks are never used as names. Older jj versions that cannot answer the fork-point query fall back to trunk() instead of failing the review.

A knowledge skill for every agent, and llms.txt

Agents had launcher skills for opening reviews but no reference for everything else Plannotator can do. The new top-level plannotator skill is that reference: every subcommand, flag, and workflow, installed for Claude Code, Codex, OpenCode, Pi, Kiro, and Gemini through their own install paths. A CI freshness guard ties the skill to the CLI source, so it cannot silently drift from what the binary actually accepts. The same document is now served at plannotator.ai/llms.txt following the llmstxt.org convention, generated from the identical source at build time.

oh-my-pi is its own agent origin

Sessions launched from the oh-my-pi harness were detected as Claude Code, because OMP exports Claude Code's environment markers into its shells. OMP is now detected as its own origin, ordered so nested runtimes still detect correctly, and sessions report the agent you are actually using.

Install / Update

macOS / Linux:
bash
curl -fsSL https://plannotator.ai/install.sh | bash
Windows:
powershell
irm https://plannotator.ai/install.ps1 | iex
Claude Code Plugin: Run /plugin in Claude Code, find plannotator, and click "Update now". Pi: Update @plannotator/pi-extension to 0.27.7 and restart Pi. OpenCode: Clear cache and restart:
bash
rm -rf ~/.bun/install/cache/@plannotator

What's Changed

  • feat: detect the oh-my-pi harness as its own agent origin by @FNDEVVE in #1373
  • fix(review): detect JJ mutable line-of-work base by @graemefolk in #1365
  • feat(skills): top-level plannotator knowledge skill with a CLI freshness guard by @backnotprop in #1377
  • fix(ai): a broken RPC pipe must fail the provider, not kill the host by @backnotprop in #1379
  • fix(call-flow): keep big-but-valid tree lists instead of failing by @ashish921998 in #1370

Contributors

Three returning contributors landed code in this release. @graemefolk continues to own Plannotator's jj support end to end, this time replacing the assumed trunk() base with real fork-point detection. @ashish921998 turned @sergdort's Call Flow measurements into the fix that stops normal reviews from failing. @FNDEVVE made oh-my-pi a first-class agent origin. Community reports that shaped this release:
  • @Kaelenx reported the Pi host crash on Windows in #1378 and verified the fix on the same machine
  • @sergdort measured exactly which Call Flow cap was failing normal reviews in #1351
Full Changelog: https://github.com/backnotprop/plannotator/compare/v0.27.6...v0.27.7

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.27.7
Free
Software Informations:
Developer:

Operating System:
Windows / macOS / Linux
Date Added:
2026-08-23T20:19:19.242Z
Categories:

Post a Comment/Report Broken Link: