submit_plan tool. The default plan-agent workflow exposes it to OpenCode’s built-in plan agent.
Install the plugin
Add Plannotator toopencode.json:
/plannotator-review, /plannotator-annotate, and /plannotator-last:
${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’splan 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:
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 tobuild, while code-review feedback stays on the current agent. After you save a choice, that target is shared by both surfaces.
Plannotator checks the configured target against OpenCode’s current agent list before delivery. If the target is missing or cannot be checked, Plannotator shows a warning. It still approves the plan or sends the feedback. It skips the agent switch and does not send the stale target to OpenCode.
Ask this session
On OpenCode 2, Ask AI in code review, annotate, and/plannotator-last is answered by your OpenCode session. It is the only Ask AI option there. In plan review, the session is waiting for your plan decision, so it gives a quick answer from its context only, and nothing is added to the conversation. OpenCode 1 and remote sessions use a separate provider that you pick. See Ask this session.
Update
Rerun the standard installer to update the binary and native command files. It clears cached Plannotator plugin packages for OpenCode 1 and OpenCode 2. Clearing the OpenCode 2 cache is new in Plannotator 0.28.0. Restart OpenCode so the configured@plannotator/opencode@latest entry reloads.
Last verified against Plannotator OSS v0.25.1 on July 31, 2026. The Ask this session and update sections were checked against Plannotator v0.28.0 on October 4, 2026. Maintained by the Plannotator project.