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: 9 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: apache-2.0
- Created: 2025-12-28T02:09:40.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-02-18T05:03:40.000Z (22 days ago)
- Last Synced: 2026-02-18T10:12:09.917Z (22 days ago)
- Topics: claude-code, obsidian, opencode
- Language: TypeScript
- Homepage: https://plannotator.ai
- Size: 24.7 MB
- Stars: 2,019
- Watchers: 11
- Forks: 121
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-claude-skills - plannotator - Interactive plan review UI for Claude Code with visual annotation, offline sharing, and Obsidian/Bear integration. (🤝 Collaboration & Project Management)
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**, **OpenCode**, and **Pi**.
Claude Code
OpenCode
### Features
Visual Plan ReviewBuilt-in hookApprove or deny agent plans with inline annotations
Plan DiffAutomaticSee what changed when the agent revises a plan
Code Review/plannotator-reviewReview git diffs with line-level annotations
Annotate Any File/plannotator-annotateAnnotate any markdown file and send feedback to your agent
#### Sharing Plans
Plannotator lets you privately share plans, annotations, and feedback with colleagues. For example, a colleague can annotate a shared plan, and you can import their feedback to send directly back to the coding agent.
Plans are shared via compressed URL through a static site: **share.plannotator.ai**
- No backend or database; nothing is stored
- The site's deployment is open source
- You can self-host your own share site and point Plannotator to it via an environment variable ([see docs](https://plannotator.ai/docs/guides/sharing-and-collaboration/))
> [!NOTE]
> [share.plannotator.ai](https://share.plannotator.ai) uses a default fallback (demo) plan that is hard-coded into the site. This isn't a leaked plan—the site has no storage layer.
## Install
- [Claude Code](#install-for-claude-code)
- [OpenCode](#install-for-opencode)
- [Pi](#install-for-pi)
## 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.
---
## Install for Pi
```bash
pi install npm:@plannotator/pi-extension
```
Then start Pi with `--plan` to enter plan mode, or toggle it during a session with `/plannotator`.
See [apps/pi-extension/README.md](apps/pi-extension/README.md) for full usage details, commands, and flags.
---
## 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 2025-2026 backnotprop
This project is licensed under either of
- [Apache License, Version 2.0](LICENSE-APACHE) ([http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0))
- [MIT license](LICENSE-MIT) ([http://opensource.org/licenses/MIT](http://opensource.org/licenses/MIT))
at your option.
### Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in this project by you, as defined in the Apache-2.0 license,
shall be dual licensed as above, without any additional terms or conditions.