# @plannotator/opencode

Interactive Plan Review for OpenCode. Mark up and refine your plans using a visual UI, share for team collaboration.

[![Watch Demo](https://img.youtube.com/vi/_N7uo0EFI-U/maxresdefault.jpg)](https://youtu.be/_N7uo0EFI-U)

## Install

Add to your `opencode.json`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@plannotator/opencode"]
}
```

Restart OpenCode. The `submit_plan` tool is now available.

## How It Works

1. Agent creates a plan and calls `submit_plan`
2. Plannotator UI opens in your browser
3. Annotate the plan visually (delete, insert, replace, comment)
4. **Approve** → Agent switches to build mode and proceeds
5. **Request changes** → Annotations are sent back as structured feedback

## Usage

Ask your agent to plan something:

```
Plan how to implement user authentication
```

When the plan is ready, the agent will call `submit_plan` and Plannotator opens for your review.

## Features

- **Visual annotations**: Select text → choose action → feedback appears in sidebar
- **Runs locally**: No network requests. Plans never leave your machine.
- **Shareable**: Plans compress into URLs for team collaboration (no backend required)

## Links

- [Main Repository](https://github.com/backnotprop/plannotator)
- [Claude Code Plugin](https://github.com/backnotprop/plannotator/tree/main/apps/hook)
- [Website](https://plannotator.ai)

## License

**Copyright (c) 2025 backnotprop.**

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