Use Plannotator with OpenCode

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:

{
  "$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:

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:

{
  "$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.

Start

Plans and documents

Code review

Reference

Agents

Editors and notes

Troubleshooting

Related project

Use Plannotator with OpenCode

Install the plugin

Review a plan

Choose a workflow

​Install the plugin

​Review a plan

​Choose a workflow

Install the plugin

Review a plan

Choose a workflow