opencode browser Markdown PT

Help and reference

13. Notices and signals

SignalWhat it means
“!” badge on the iconPairing still needs to be configured
Badge with a numberHow many conversations have news (at most 9)
Green/red/amber dot in the headerAPI online, offline or connecting
Connection bannerExplains the failure and offers Try again, Reconnect or Open settings
Status strip below the chatReconnection attempts and backend messages
Blue border on the pageThe agent is acting on that tab; it has a Stop button
“tools connected” / “tools offline”Plugin state in the composer footer
Sound + notificationSomething happened with the panel closed (run finished, permission, question)
Temporary notice in the footerConfirmation or error from one of your actions

14. Common problems

SymptomLikely causeWhat to do
The panel says OpenCode is not respondingServer stoppedRun opencode serve and click Try again
“OpenCode token invalid or expired”Token revoked or replacedRun opencode pair and paste the new link in the settings
“OpenCode took too long to respond”Server stuckRestart OpenCode
Tools offlinePlugin not installed or an old service still in memorynpm run install:plugin + opencode service restart
“Plugin refused the connection”Extension ID different from the expected oneReload the extension; if it persists, adjust OPENCODE_BROWSER_EXTENSION_ID
The agent cannot find browser_tabs_closeName reserved by another pluginUse browser_tabs_close_tab and reschedule the tools
Code changes do not show upService worker cachedReload in chrome://extensions
“Could not prepare the page…”chrome:// page, Chrome Web Store or a blank tabOpen a normal page and try again
“DevTools is open on this tab…”DevTools interferes with the automationClose DevTools on that tab
“Ref … is inside an iframe…”Coordinate-based action on an iframe elementAsk for the action by reference (click/fill in)
“Ref … not found”The page changed after it was readAsk the agent to read the page again
“Only http(s) tabs can be attached.”Internal browser tabUse a regular page
“The tab is in another window…”The group belongs to another windowOpen a tab from the conversation or move the tab to another window
“The file … exceeds the ~5 MB limit.”Upload too largeShrink the file
“No frames recorded…”GIF without startAsk to start the recording first
“Failed to generate the GIF (offscreen unavailable).”The offscreen document did not startReload the extension
403 error on the toolsOutdated relay tokenDelete ~/.cache/opencode-browser/relay.json (or under $XDG_RUNTIME_DIR/opencode-browser/) and restart OpenCode

15. Limits and privacy


16. Quick reference

Paths

WhatWhere
Extension builddist/ (it is the folder to load in Chrome)
Plugin and agent~/.config/opencode/plugins/
Browser conversations~/.opencode-browser-extensions
Agent screenshots~/.cache/opencode-browser/capturas/
Relay token and port$XDG_RUNTIME_DIR/opencode-browser/relay.json or ~/.cache/opencode-browser/relay.json

Useful commands

npm run build              # generates dist/
npm run install:plugin     # copies plugin and agent
opencode service restart   # reloads plugin and agent
opencode pair              # generates the pairing link
curl http://127.0.0.1:8799/health

Requests that work well