> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plannotator.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Plannotator with OpenCode

> Add the Plannotator OpenCode plugin, choose its planning workflow, and install manual review commands.

The OpenCode plugin gives configured planning agents a `submit_plan` tool. The default `plan-agent` workflow exposes it to OpenCode's built-in `plan` agent.

## Install the plugin

Add Plannotator to `opencode.json`:

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

Restart OpenCode.

Run the standard installer if you also want `/plannotator-review`, `/plannotator-annotate`, and `/plannotator-last`:

```bash theme={null}
curl -fsSL https://plannotator.ai/install.sh | bash
```

## Review a plan

Use OpenCode's `plan` agent. When it calls `submit_plan`, Plannotator opens the plan in the browser. Approval lets the agent continue. Feedback returns structured annotations for revision.

By default, `submit_plan` is not exposed to `build` or other primary agents.

## Choose a workflow

Use the expanded plugin entry when you need a different scope:

```json theme={null}
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    ["@plannotator/opencode@latest", {
      "workflow": "plan-agent",
      "planningAgents": ["plan", "sisyphus"]
    }]
  ]
}
```

Supported workflows:

| Workflow       | Behavior                                                                            |
| -------------- | ----------------------------------------------------------------------------------- |
| `plan-agent`   | Exposes `submit_plan` to `plan` and names in `planningAgents`. This is the default. |
| `manual`       | Does not register `submit_plan`. Use Plannotator commands when needed.              |
| `user-managed` | Registers the tool without modifying prompts or permissions.                        |
| `all-agents`   | Exposes the tool broadly to primary agents. This preserves the older behavior.      |

Keep options inside the two-item Plannotator plugin entry. Do not add the options object as a separate item in the `plugin` array.

OpenCode uses the plugin's embedded server under Bun. In Node-based or wrapped environments, it falls back to the installed `plannotator` command.

Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project.