Plannotator: a local browser review surface for multi-agent work
A local browser review surface for AI agents such as Claude Code that annotates plans and code and sends feedback back to the agent.
GitHub backnotprop/plannotator Updated 2026-11-14 Branch main Stars 10.5K Forks 785
TypeScript AI coding-agent review Plannotator Inbox macOS/Linux/WSL/Windows

🧭 Decision Guide

Try it if you

  • You use Claude Code, Codex, or Gemini CLI and need to review plans and provide feedback during agent execution.
    The README section “Plannotator” lists these agents and says the browser review surface opens when an agent proposes a decision or plan.
  • You need to annotate Markdown, HTML, or other interactive artifacts rather than only reviewing plain-text logs.
    The README introduction states that it can annotate plans, specs, Markdown, HTML, and other interactive artifacts.
  • You want Plannotator Inbox to collect decisions, prototypes, variations, and plans from multi-agent work.
    The README section “Plannotator Inbox” describes it as a review layer for these items and says it works with coding agents and personal assistants.

Skip it if you

  • You use Codex on native Windows and do not accept experimental hooks or manual setup steps.
    The Codex row in the installation table says hooks are experimental on native Windows and that the installer prints manual setup steps.
  • You use Droid and require automatic plan-mode interception rather than commands only.
    The Droid row in the installation table explicitly says “Commands only, no plan interception yet.”
  • Your environment forbids the installer from contacting GitHub, npm, or Ataraxy-Labs/sem.
    The README section “Install” says a full install may contact GitHub, Ataraxy-Labs/sem, and npm; --minimal skips skills, hooks, and per-agent configuration.

Requirements

  • Use install.sh on macOS, Linux, or WSL; use install.ps1 on Windows.
  • The Gemini CLI integration requires Gemini CLI 0.36.0+.
  • Claude Code, Copilot CLI, Droid, and other integrations require their respective plugin marketplace or host CLI configuration.
  • Pi does not use the universal installer; the README requires npm:@plannotator/pi-extension.
  • The installer installs the plannotator binary; --minimal installs it to ~/.local/bin.

First step (verbatim from README)

curl -fsSL https://plannotator.ai/install.sh | bash

Watch out

  • Using --minimal does not install skills, hooks, slash commands, or per-agent configuration.
    The README section “Install” states this for --minimal.
  • Updating the Claude Code plugin requires a restart; refreshing the marketplace alone does not update it.
    The README section “Updating” requires restarting Claude Code and states that refreshing the marketplace alone does not update the plugin.
  • plannotator uninstall --purge removes known local data and cannot be recovered.
    The README section “Uninstall” says purge requires typing purge and that the local-only data cannot be recovered.
  • On Claude Code 2.1.287 or newer, review feedback can arrive later as a message by default.
    The README section “Updating” says that on Claude Code 2.1.287 or newer, plan review, code review, and annotation do not make Claude wait.

Not stated in the README

  • The excerpt does not specify supported browsers or minimum browser versions.
  • The excerpt provides no performance data for large teams, long-running tasks, or high-concurrency Inbox usage.
  • The excerpt does not provide a complete agent version compatibility matrix; requirements for agents other than Gemini CLI 0.36.0+ are unknown.
  • The Security, Privacy and network behavior, and Remote / SSH / devcontainer sections were omitted, so the concrete security boundaries and remote-environment limitations are unknown.
  • The excerpt does not explain the deployment model, account requirements, or team permission model for Plannotator Inbox.

💡 Deep Analysis

6
It depends I handle sensitive code in a restricted enterprise network and may install only the `plannotator` binary. I cannot allow default access to npm, GitHub release resolution, or extra sidecars. Should I use the full installer or minimal mode?
For: A security engineer handling sensitive code in a restricted enterprise network who may install only a single binary and needs explicit network boundaries

It depends: minimal mode best matches the single-binary constraint, but it skips agent integration and is not equivalent to the full workflow.

  • The README says a full install may contact GitHub beyond downloading the release, the optional Ataraxy-Labs/sem sidecar, and npm for Pi, extra skills, or the managed agent-terminal runtime.
  • --minimal installs only the plannotator binary to ~/.local/bin and skips all skills, hooks, slash commands, and per-agent configuration, reducing the network and supply-chain surface.
  • The project is a local, browser-based review surface, which is suitable when sensitive code should not be uploaded to a third-party service. However, that does not mean the installer and agent extensions are fully offline.

Minimal is viable if the team can configure agents separately and accepts core CLI functionality. Automatic Claude Code or Codex integration requires additional network-boundary review.

  • Install: "A full install can also contact GitHub... Ataraxy-Labs/sem... and npm"
  • Install: "Pass `--minimal` ... install only the `plannotator` binary to `~/.local/bin`"
  • Install: minimal mode skips skills, hooks, slash commands, and per-agent config
  • README quote: "Plannotator is a local, browser-based review surface"
curl -fsSL https://plannotator.ai/install.sh | bash -s -- --minimal
Not stated in the README:The excerpt does not provide a fully offline installation process, predownload verification, or binary-signature verification procedure;It does not specify the manual files and permissions required for each agent under minimal mode
Yes I use Claude Code on macOS, Linux, or WSL. I want a browser to open automatically when the agent proposes a plan so I can approve, annotate, or request changes and send the result back to Claude Code. Is Plannotator suitable?
For: A developer using Claude Code on macOS, Linux, or WSL who wants browser-based plan review before execution and direct feedback return

Yes, because the README explicitly provides Claude Code integration, plan review, and direct feedback return.

  • The installer detects installed agents and configures hooks, skills, and slash commands; Claude Code still requires /plugin marketplace add backnotprop/plannotator and plugin installation.
  • Plannotator is a local browser review surface. When the agent proposes a decision, plan, HTML artifact, or finishes work, the browser opens so annotations and feedback can be sent back.
  • macOS, Linux, and WSL are covered by the shared installer command. Claude Code 2.1.287+ also supports a non-blocking flow where the decision arrives later as a message.

The README does not define the full compatibility boundary for older Claude Code versions or complex existing plugin configurations.

  • Install: macOS / Linux / WSL installer command
  • Install: Claude Code `/plugin marketplace add backnotprop/plannotator`
  • README quote: "It plugs directly into your agent through plugins, hooks and commands."
  • Updating: "On Claude Code 2.1.287 or newer..."
curl -fsSL https://plannotator.ai/install.sh | bash
Not stated in the README:The excerpt does not explain conflict handling with existing Claude Code plugins or custom hooks;It does not specify browser performance limits for very large plans or diffs
Yes I run Claude Code, Codex, Gemini CLI, and OpenCode simultaneously and do not want to switch between terminals. I need one Inbox for plans, prototypes, variations, and decisions, with feedback sent back to the originating agent. Is Plannotator worth adopting?
For: An engineer running Claude Code, Codex, Gemini CLI, and OpenCode who needs one place to review plans, prototypes, and decisions

Yes, because Inbox is specifically presented as the unified review layer for multi-agent workflows.

  • The README describes Plannotator Inbox as surfacing decisions, prototypes, variations, and plans, and says it works with all coding agents and personal assistants.
  • Claude Code, Codex, Gemini CLI, and OpenCode all appear in the supported integration list, matching your four hosts.
  • Integration differs by host: Claude Code and Gemini CLI use plugin or hook configuration, Codex uses a Stop hook, and OpenCode requires adding a plugin entry to opencode.json.
  • The browser supports marking up, commenting, and sending feedback directly to the agent, reducing manual context transfer between terminals.

However, the README does not specify Inbox sorting, permissions, or team operating rules when many parallel items accumulate.

  • README quote: "Plannotator Inbox ... surfaces decisions, prototypes, variations, plans"
  • README quote: "Works with all coding agents and personal assistants."
  • Install: Claude Code, Codex, Gemini CLI, and OpenCode are listed
  • README quote: "mark it up, comment, and send feedback directly to the agent"
curl -fsSL https://plannotator.ai/install.sh | bash
Not stated in the README:The excerpt does not describe Inbox sorting, archiving, or notification behavior for many agents;It does not explain how sessions and permissions are separated when multiple agents return items for one project
Yes I use Gemini CLI 0.36.0+ and need browser annotations for plans, Markdown, specifications, and interactive HTML prototypes, with feedback returned to the agent. Is Plannotator more suitable than terminal-only review?
For: A product engineer using Gemini CLI 0.36.0+ who needs to review Markdown, specifications, and HTML prototypes during planning

Yes, because it combines automatic Gemini CLI integration with visual annotation for plans, documents, and HTML artifacts.

  • The README requires Gemini CLI 0.36.0+ and says the hook, policy, and slash commands are configured automatically, without an additional plugin command.
  • The product description explicitly supports annotating plans, specifications, Markdown, HTML, and other interactive artifacts, as well as reviewing diffs and PRs.
  • When the agent proposes a plan, HTML, or another artifact, the browser opens a review page where users can mark up, comment, and send feedback directly back.
  • This is better than terminal-only text review when feedback must refer to visual structure, prototype interaction, or exact document locations.

The README does not clarify whether complex HTML retains all browser-runtime capabilities or define loading limits for very large documents.

  • Install: Gemini CLI entry, "Requires Gemini CLI 0.36.0+"
  • Install: "The hook, policy, and slash commands are configured automatically"
  • README quote: "Annotate plans, specs, markdown, HTML, and other interactive artifacts."
  • README quote: "When the agent proposes a decision, plan, html... the app opens in your browser"
curl -fsSL https://plannotator.ai/install.sh | bash
Not stated in the README:The excerpt does not specify how scripts, external resources, and interaction state are preserved in complex HTML;It does not define compatibility boundaries across Gemini CLI versions newer than 0.36.0
It depends I use Codex CLI on native Windows and require automatic interception when the agent enters plan mode, rather than only manual commands. Does Plannotator meet that requirement?
For: A developer using Codex CLI on native Windows who needs automatic plan interception

It depends: Codex plan review is available, but native Windows has a weaker automation path than macOS, Linux, and WSL.

  • The README says Codex plan review is enabled automatically through Codex’s experimental Stop hook, with support listed for macOS, Linux, and WSL.
  • For native Windows, the README explicitly says Codex hooks are experimental and that the installer prints manual setup steps. Therefore, one-click automatic interception cannot be treated as guaranteed.
  • The $plannotator-review, $plannotator-annotate, and $plannotator-last skills are included for Codex and can provide manual entry points.

If stable, no-manual-configuration interception on native Windows is a hard requirement, the available evidence is insufficient. If manual setup or WSL is acceptable, the fit is better.

  • Install, Codex entry: "Nothing. Plan review is enabled automatically via Codex's experimental `Stop` hook (macOS/Linux/WSL...)"
  • Install: "on native Windows, Codex hooks are experimental and the installer prints manual setup steps"
  • Install: Codex skills `$plannotator-review`, `$plannotator-annotate`, `$plannotator-last`
irm https://plannotator.ai/install.ps1 | iex
Not stated in the README:The excerpt does not include the complete native Windows manual setup procedure;It does not provide a compatibility matrix for the experimental Stop hook across Codex CLI versions
It depends I run OpenCode inside SSH or a devcontainer. The code must stay in the development environment, but I want to review diffs, plans, and documents in a local browser and return comments to OpenCode. Is Plannotator suitable for this deployment?
For: A developer running OpenCode in SSH or a devcontainer who needs browser review without moving code to a third-party cloud service

It depends: the project explicitly includes Remote, SSH, and devcontainer scenarios, but network forwarding and access control between the remote agent and local browser remain prerequisites.

  • The project insights list Remote, SSH, and devcontainer support within the intended feature scope.
  • The README describes Plannotator as a local, browser-based review surface, with feedback returned through the host agent rather than automatically sending code to a cloud service.
  • OpenCode requires adding "plugin": ["@plannotator/opencode@latest"] to opencode.json and restarting; that configuration must still be completed inside the remote environment.
  • Link sharing, remote environments, and team collaboration introduce additional access-control and exposure risks and should not be treated exactly like single-machine local mode.

The fit is good if secure port forwarding and browser access can be established. The README does not specify forwarding commands, authentication, or the exact cross-container return topology.

  • Project insights: "README ... includes Remote, SSH and devcontainer scenarios"
  • README quote: "Plannotator is a local, browser-based review surface"
  • Install: OpenCode requires adding the plugin to `opencode.json` and restarting
  • Project insights, common pitfalls: remote environments and link sharing add access-control and exposure risks
Not stated in the README:The excerpt does not provide concrete SSH forwarding, devcontainer port exposure, or browser-access commands;It does not describe identity authentication, TLS, or the cross-machine permission model for remote sessions

✨ Highlights

  • Supports agents including Claude Code, Codex, and Gemini CLI
  • Plannotator Inbox covers decisions, prototypes, plans, and feedback
  • One installer configures hooks, skills, and slash commands
  • A full install contacts GitHub, npm, and the optional sem sidecar

🔧 Engineering

  • Annotate plans, Markdown, HTML, and interactive artifacts in a browser
  • Send feedback back to agents through hooks, plugins, and commands
  • Code Review supports reviewing diffs and pull requests
  • Plannotator Inbox works with Grok Bot, Muse, and Hermes

⚠️ Risks

  • A full install contacts GitHub Releases, npm, and Ataraxy-Labs/sem
  • Codex hooks remain experimental on native Windows
  • The Gemini CLI integration requires version 0.36.0 or newer
  • Droid currently has commands only and no plan interception

👥 For who?

  • AI development teams using Claude Code, Codex, or Gemini CLI
  • Engineers who review plans, diffs, PRs, and HTML artifacts
  • Users running agents on macOS, Linux, WSL, or Windows
  • Personal-assistant users who need unified multi-agent feedback