https://github.com/backnotprop/plannotator
Annotate and review coding agent plans visually, share with your team, send feedback with one click.
https://github.com/backnotprop/plannotator
claude-code obsidian opencode
Last synced: 3 days ago
JSON representation
Annotate and review coding agent plans visually, share with your team, send feedback with one click.
- Host: GitHub
- URL: https://github.com/backnotprop/plannotator
- Owner: backnotprop
- License: other
- Created: 2025-12-28T02:09:40.000Z (25 days ago)
- Default Branch: main
- Last Pushed: 2026-01-16T04:56:21.000Z (6 days ago)
- Last Synced: 2026-01-16T18:47:01.647Z (5 days ago)
- Topics: claude-code, obsidian, opencode
- Language: TypeScript
- Homepage: https://plannotator.ai
- Size: 24.5 MB
- Stars: 1,155
- Watchers: 10
- Forks: 70
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
OpenCode
**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](https://obsidian.md/) and [Bear Notes](https://bear.app/)
## Install for Claude Code
**Install the `plannotator` command:**
**macOS / Linux / WSL:**
```bash
curl -fsSL https://plannotator.ai/install.sh | bash
```
**Windows PowerShell:**
```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](apps/hook/README.md) for detailed installation instructions including a `manual hook` approach.
---
## Install for OpenCode
Add to your `opencode.json`:
```json
{
"plugin": ["@plannotator/opencode@latest"]
}
```
**Run the install script** to get `/plannotator-review`:
```bash
curl -fsSL https://plannotator.ai/install.sh | bash
```
**Windows:**
```powershell
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)**.