Skip to main content
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:
Restart OpenCode. Run the standard installer if you also want /plannotator-review, /plannotator-annotate, and /plannotator-last:
These are native OpenCode Markdown command files. On macOS, Linux, and WSL, the installer uses ${XDG_CONFIG_HOME:-$HOME/.config}/opencode/commands. On Windows PowerShell and Command Prompt, it uses %USERPROFILE%\.config\opencode\commands. They are separate from Plannotator’s Agent Skills. See Install and Manage Plannotator Skills for the artifact differences.

​
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:
Supported workflows: 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.

​
Switch agents after a review

Plannotator can ask OpenCode to switch agents after plan approval or code-review feedback. Choose the target from the approval menu or Settings. When you have not saved a choice, plan approval switches from the planning agent to build, while code-review feedback stays on the current agent. After you save a choice, that target is shared by both surfaces. Plannotator validates the configured target against OpenCode’s current agent list before delivery. If the target is missing or cannot be validated, it shows a warning, approves the plan or sends the feedback without switching, and does not pass the stale target to OpenCode. Rerun the standard installer to update the binary and native command files. It clears cached Plannotator plugin packages; restart OpenCode so the configured @plannotator/opencode@latest entry reloads. Last verified against Plannotator OSS v0.25.1 on July 31, 2026. Maintained by the Plannotator project.
Last modified on July 31, 2026