OpenCode

The plugin gives OpenCode the Inbox tool and plan review. On OpenCode 2 your reply arrives as its next turn.

Native plug-in · Inbox built in and your reply wakes it

Set it up

Install Plannotator.

curl -fsSL https://plannotator.ai/install.sh | bash

You should see The installer ends with Then restart OpenCode (OpenCode 2: run opencode2 reload).
Add the plugin to opencode.json. This is OpenCode 2.
opencode.json
{ "plugins": [{ "package": "@plannotator/opencode@latest" }] }
Open the Inbox. It connects the agents it finds on this computer.

plannotator inbox

You should see The Inbox opens in your browser. Settings → Agents lists OpenCode through Plannotator’s plugin.
plannotator inbox turned the tool on when it found the plugin. Reload OpenCode.

opencode2 reload

You should see opencode2 plugin list shows plannotator and OpenCode has a plannotator_inbox tool.

Other ways

On Windows

Install Plannotator from PowerShell. The other steps are the same.

irm https://plannotator.ai/install.ps1 | iex

OpenCode 1

OpenCode 1 reads plugin. Restart OpenCode after. It gets the tool but replies don’t wake it.

opencode.json

{ "plugin": ["@plannotator/opencode@latest"] }

Turn the tool on without the Inbox

Merge this into your Plannotator config. Then reload OpenCode.

~/.plannotator/config.json

{ "inboxTool": { "opencode": true } }

Check it works

Paste this into OpenCode.

Send me a test question in the Plannotator Inbox, and read my answer when I tell you I sent it.

You should see A question arrives in the Inbox. Answer it and press Send. The thread reads Delivered to OpenCode and OpenCode goes on with your answer.

Troubleshooting

OpenCode has no plannotator_inbox tool: Run plannotator inbox once: it turns the tool on when it finds the plugin in your global OpenCode config. If you turned the tool off yourself, turn it on in Settings → Agents. Then run opencode2 reload on OpenCode 2 or restart OpenCode 1.
OpenCode says Plugin is not configured: Update the plugin.

opencode2 models && opencode2 plugin update @plannotator/opencode@latest
An update didn’t load: Point the plugin at @latest rather than an exact version. Then opencode2 reload or opencode2 service restart.
On OpenCode 1 your reply never shows up on its own: Nothing can wake OpenCode 1: it sees a reply when it reads the thread. Tell it to check the Inbox.
The tool says to install Plannotator: It found no plannotator binary. Install Plannotator or set PLANNOTATOR_BIN to its path.
The Inbox doesn’t open: Read ~/.plannotator/inbox/inbox.log. Stop a stuck Inbox process and run plannotator inbox again.

What works

Inbox tool Built in, off at first
Reply wakes it Wakes OpenCode 2
Start from Inbox No
Permission cards No

Plan review Yes
Code review Yes
Annotate Files and last reply
Ask this session OpenCode 2

Cancelling a turn doesn’t close a review that is open.
The Windows installers don’t update the OpenCode 2 service for you.

Examples

Ask the plan agent for a plan and review it in Plannotator.
Answer a question with picture choices in the Inbox.

A question from OpenCode with three invoice layouts as picture choices and the second one picked

Every agent Full OpenCode guide