Skip to content

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

License

Notifications You must be signed in to change notification settings

0rdep/plannotator

 
 

Repository files navigation

Plannotator

Plannotator

Interactive Plan Review for AI Coding Agents. Mark up and refine your plans using a visual UI, share for team collaboration, and seamlessly integrate with Claude Code and OpenCode.

Claude Code

Claude Code Demo

Watch Demo

OpenCode

OpenCode Demo

Watch Demo

New:

  • Code Review (Jan 2026) — Run /plannotator-review to review git diffs with inline annotations (select line numbers to annotate), switch between diff views, and send feedback to your agent
  • Attach and annotate images with your feedback (pen, arrow, circle tools)
  • Auto-save approved plans to Obsidian and Bear Notes

Install for Claude Code

Install the plannotator command:

macOS / Linux / WSL:

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

Windows PowerShell:

irm https://plannotator.ai/install.ps1 | iex

Then in Claude Code:

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

# IMPORTANT: Restart Claude Code after plugin install

See apps/hook/README.md for detailed installation instructions including a manual hook approach.


Install for OpenCode

Add to your opencode.json:

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

Run the install script to get /plannotator-review:

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

Windows:

irm https://plannotator.ai/install.ps1 | iex

This also clears any cached plugin versions. Then restart OpenCode.


How It Works

When your AI agent finishes planning, Plannotator:

  1. Opens the Plannotator UI in your browser
  2. Lets you annotate the plan visually (delete, insert, replace, comment)
  3. Approve → Agent proceeds with implementation
  4. Request changes → Your annotations are sent back as structured feedback

License

Copyright (c) 2025 backnotprop.

This project is licensed under the Business Source License 1.1 (BSL).

About

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

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 80.7%
  • Shell 12.4%
  • CSS 3.3%
  • HTML 1.5%
  • PowerShell 1.0%
  • Batchfile 0.9%
  • Dockerfile 0.2%