Plannotator works in devcontainers and Docker environments with minimal configuration.
Add these to your devcontainer.json:
{
"containerEnv": {
"PLANNOTATOR_REMOTE": "1",
"PLANNOTATOR_PORT": "9999"
},
"forwardPorts": [9999]
}| Variable | Purpose |
|---|---|
PLANNOTATOR_REMOTE=1 |
Tells Plannotator not to open a browser (required in containers) |
PLANNOTATOR_PORT=9999 |
Fixed port for the UI (required for port forwarding) |
Both are required. Just setting the port isn't enough.
Ensure port 9999 (or your chosen port) is forwarded to your host. In VS Code devcontainers, add it to forwardPorts as shown above.
- Run OpenCode in your container (
opencodeoropencode web) - Ask the agent to create a plan
- When
submit_planis called, Plannotator starts on port 9999 - Open
http://localhost:9999in your host browser - Approve or deny the plan
Note: There's no browser auto-open or notification in remote mode. You'll need to manually navigate to the URL when you see the agent call submit_plan.
opencode web works in devcontainers. Forward port 4096 (default) for the OpenCode UI, and port 9999 for Plannotator:
{
"forwardPorts": [4096, 9999]
}If your environment already has SSH_TTY or SSH_CONNECTION set (common in SSH sessions), Plannotator will detect remote mode automatically. The PLANNOTATOR_REMOTE env var is preferred for Docker/devcontainer setups where those aren't present.
Plugin not updating?
rm -rf ~/.bun/install/cache/@plannotatorOpenCode crashes on startup?
rm -rf ~/.cache/opencode ~/.bun/install/cache/@opencode-aiPort not accessible? Check your devcontainer's port forwarding. In VS Code, check the "Ports" tab.