AgentToolHub
SkillClaude CodeCursorClineOpenClawWindsurfVS CodeChatGPT

plannotator-visual-explainer

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

Features

  • ✓Visualize AI coding agent plans and diffs
  • ✓Markdown and HTML artifact annotation
  • ✓Direct feedback to agents with one click
  • ✓Integrates with popular AI coding agents
  • ✓Browser-based review for seamless collaboration

Installation Guide

One installer covers almost every agent. It installs the plannotator binary, auto-detects your installed agents, and configures hooks, skills, and slash commands for each:

bash
# macOS / Linux / WSL
curl -fsSL https://plannotator.ai/install.sh | bash
powershell
# Windows PowerShell
irm https://plannotator.ai/install.ps1 | iex

Want just the binary and nothing else? Pass --minimal (or export PLANNOTATOR_MINIMAL=1) to install only the plannotator binary to ~/.local/bin, skipping every skill, hook, slash command, and per-agent config:

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

Then finish the step for your agent:

| Agent | After the installer | Details |
|---|---|---|
| Amp | Copy [plannotator.ts](apps/amp-plugin/plannotator.ts) into ~/.config/amp/plugins/, then plugins: reload. Workflows live in the command palette. | [README](apps/amp-plugin/README.md) |
| Claude Code | /plugin marketplace add backnotprop/plannotator, then /plugin install plannotator@plannotator. Restart Claude Code. | [README](apps/hook/README.md) |
| Codex | Nothing. Plan review is enabled automatically via Codex's experimental Stop hook (macOS/Linux/WSL; Codex hooks are disabled on Windows). $plannotator-review, $plannotator-annotate, and $plannotator-last skills included. | [README](apps/codex/README.md) |
| Copilot CLI | /plugin marketplace add backnotprop/plannotator, then /plugin install plannotator-copilot@plannotator. Restart. Plan review activates in plan mode (Shift+Tab). | [README](apps/copilot/README.md) |
| Droid | droid plugin marketplace add https://github.com/backnotprop/plannotator, then droid plugin install plannotator@plannotator. Commands only, no plan interception yet. | [README](apps/droid-plugin/README.md) |
| Gemini CLI | Nothing. The hook, policy, and slash commands are configured automatically. Requires Gemini CLI 0.36.0+. | [README](apps/gemini/README.md) |
| Kiro CLI | Nothing. Skills and an example agent are installed automatically. Try kiro-cli chat --agent plannotator. | [README](apps/kiro-cli/README.md) |
| OpenCode | Add "plugin": ["@plannotator/opencode@latest"] to opencode.json. Restart OpenCode. | [README](apps/opencode-plugin/README.md) |
| Pi | Skip the installer. Just pi install npm:@plannotator/pi-extension. Start Pi with --plan, or toggle with /plannotator. | [README](apps/pi-extension/README.md) |

Full walkthroughs live in the installation docs.

<details>
<summary>Claude Code: manual hook setup (without the plugin system)</summary>

Add to ~/.claude/settings.json:

json
{
  "hooks": {
    "PermissionRequest": [
      {
        "matcher": "ExitPlanMode",
        "hooks": [
          {
            "type": "command",
            "command": "plannotator",
            "timeout": 345600
          }
        ]
      }
    ]
  }
}

</details>

<details>
<summary>Pin a specific version</summary>

bash
curl -fsSL https://plannotator.ai/install.sh | bash -s -- --version vX.Y.Z
powershell
& ([scriptblock]::Create((irm https://plannotator.ai/install.ps1))) -Version vX.Y.Z

</details>

Try it

The fastest way to see what Plannotator does is to invoke it yourself, right now, from your agent:

text
/plannotator-last                   # annotate the agent's last reply
/plannotator-review                 # review your current diff, PR-style
/plannotator-annotate report.html   # annotate any file, folder, or URL

(Slash commands in most agents; $plannotator-* skills in Codex, command palette in Amp.)

Plan review needs no command at all. The next time your agent proposes a plan, it opens in your browser automatically.

---

Reviews