Plannotator offers a visual interface for reviewing and annotating AI coding agent plans, enhancing collaboration and feedback loops. It targets developers using AI agents like Claude Code and OpenCode, enabling more precise refinement of generated plans before execution, thereby improving the quality and accuracy of AI-assisted coding.

How It Works

Upon AI plan generation, Plannotator launches a browser-based UI. Users can visually mark up plans—deleting, inserting, or commenting on steps—using tools like pen and shapes. Approving proceeds with implementation, while requesting changes sends structured feedback, including image annotations, back to the agent for revision.

Quick Start & Requirements

• Installation:
  • Claude Code: Run curl -fsSL https://plannotator.ai/install.sh | bash (macOS/Linux/WSL) or powershell irm https://plannotator.ai/install.ps1 | iex (Windows). Then, use /plugin marketplace add backnotprop/plannotator and /plugin install plannotator@plannotator within Claude Code, followed by a restart.
  • OpenCode: Add "@plannotator/opencode@latest" to your opencode.json and restart OpenCode.
• Prerequisites: Requires Claude Code or OpenCode environment. Detailed manual installation instructions are available in apps/hook/README.md.
• Resources: Setup involves script execution and IDE restarts. Cache clearing may be needed for updates.
• Links: Official demos for Claude Code and OpenCode are available.

Highlighted Details

• Visual annotation tools include pen, arrow, and circle for image feedback.
• Supports direct integration with Claude Code and OpenCode.
• Plans can be automatically saved to Obsidian and Bear Notes upon approval.
• Facilitates team collaboration through plan sharing.

Maintenance & Community

No specific details on contributors, community channels (like Discord/Slack), or roadmap were provided in the README excerpt.

Licensing & Compatibility

Licensed under the Business Source License 1.1 (BSL). This license may impose restrictions on commercial use or redistribution, often converting to a more permissive license after a specified period. Compatibility for commercial use requires careful review of the BSL terms.

Limitations & Caveats

The BSL license may impose restrictions on commercial use or offering the software as a service. Detailed installation instructions are referenced in a separate file (apps/hook/README.md), suggesting potential complexity for manual setups.