Plannotator - Interactive Plan Review for AI Coding Agents

Plannotator is an interactive plan review tool that allows developers to visualize, annotate, and refine AI coding agent plans. It provides a collaborative interface for reviewing AI-generated plans before implementation, with seamless integration with popular AI coding assistants.

Features

Visual Plan Review

• Built-in hook to approve or deny agent plans with inline annotations
• Visual markup for plans including delete, insert, replace, and comment operations
• Real-time feedback capability

Plan Diff

• Automatic diff tracking when the agent revises a plan
• Clear visualization of changes between plan versions

Code Review

• /plannotator-review command for reviewing git diffs with line-level annotations
• Detailed feedback on code changes

Annotate Any File

• /plannotator-annotate command for annotating markdown files
• Send feedback directly to your AI coding agent

Sharing Plans

• Private sharing of plans, annotations, and feedback with colleagues
• Small plans are encoded entirely in the URL hash (no server required)
• Large plans use end-to-end encrypted short links
• Zero-knowledge storage similar to PrivateBin
• Pastes auto-delete after 7 days

Integrations

Plannotator seamlessly integrates with multiple AI coding platforms:

Claude Code

• Install the plannotator command with:

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

• In Claude Code:

  /plugin marketplace add backnotprop/plannotator
  /plugin install plannotator@plannotator

• Restart Claude Code after plugin installation

OpenCode

• Add to your opencode.json:

  {
    "plugin": ["@plannotator/opencode@latest"]
  }

• Run the install script:

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

• Then restart OpenCode

Pi

• Install with:

  pi install npm:@plannotator/pi-extension

• Start Pi with --plan to enter plan mode, or use /plannotator during a session

Codex

• Install the plannotator command:

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

• Use commands in Codex:

  !plannotator review    # Code review for current changes
  !plannotator annotate file.md  # Annotate a markdown file

How It Works

1. Your AI coding agent finishes planning
2. Plannotator opens the UI in your browser
3. You can annotate the plan visually (delete, insert, replace, comment)
4. Approve → Agent proceeds with implementation
5. Request changes → Annotations are sent back as structured feedback

Security & Privacy

• Plans are encrypted with AES-256-GCM in your browser before upload
• The server stores only ciphertext it cannot read
• Decryption key lives only in the shared URL
• Zero-knowledge architecture ensures privacy

Open Source & Self-Hostable

Plannotator is fully open source and can be self-hosted. See the documentation for setup instructions.

License

Copyright 2025-2026 backnotprop Dual licensed under:

• Apache License, Version 2.0
• MIT license