🧭 Decision Guide
Why trending now: Cannot be determined from the provided materials.
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?
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/semsidecar, and npm for Pi, extra skills, or the managed agent-terminal runtime. --minimalinstalls only theplannotatorbinary to~/.local/binand 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
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?
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/plannotatorand 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
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?
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
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?
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
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?
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
Stophook, 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-lastskills 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
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?
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"]toopencode.jsonand 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
✨ 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