opencode browser Markdown

Ajuda e referência

13. Avisos e sinais

SinalO que significa
Badge “!” no íconeFalta configurar o pareamento
Badge com númeroQuantas conversas têm novidade (no máximo 9)
Ponto verde/vermelho/âmbar no cabeçalhoAPI online, offline ou conectando
Banner de conexãoExplica a falha e oferece Tentar novamente, Reconectar ou Abrir configurações
Faixa de status abaixo do chatTentativas de reconexão e mensagens do backend
Borda azul na páginaO agente está agindo naquela aba; tem botão Parar
“ferramentas conectadas” / “ferramentas offline”Estado do plugin no rodapé do composer
Som + notificaçãoAlgo aconteceu com o painel fechado (fim de execução, permissão, pergunta)
Aviso temporário no rodapéConfirmação ou erro de uma ação sua

14. Problemas comuns

SintomaCausa provávelO que fazer
Painel diz que o OpenCode não está respondendoServidor paradoRode opencode serve e clique em Tentar novamente
“Token do OpenCode inválido ou expirado”Token revogado ou trocadoopencode pair e cole o link novo nas configurações
“O OpenCode demorou demais para responder”Servidor travadoReinicie o OpenCode
Ferramentas offlinePlugin não instalado ou serviço antigo em memórianpm run install:plugin + opencode service restart
“Plugin recusou a conexão”ID da extensão diferente do esperadoRecarregue a extensão; se persistir, ajuste OPENCODE_BROWSER_EXTENSION_ID
O agente não acha browser_tabs_closeNome reservado por outro pluginUse browser_tabs_close_tab e reagende as ferramentas
Mudança no código não apareceService worker em cacheRecarregar em chrome://extensions
“Não foi possível preparar a página…”Página chrome://, Chrome Web Store ou aba em brancoAbra uma página normal e tente de novo
“O DevTools está aberto nesta aba…”DevTools interfere na automaçãoFeche o DevTools daquela aba
“A ref … está dentro de um iframe…”Ação por coordenadas em elemento de iframePeça a ação por referência (clicar/preencher)
“Ref … não encontrada”A página mudou depois da leituraPeça ao agente para ler a página de novo
“Só é possível anexar abas http(s).”Aba interna do navegadorUse uma página comum
“A aba está em outra janela…”Grupo pertence a outra janelaAbra uma aba pela conversa ou mova a aba de janela
“O arquivo … excede o limite de ~5 MB.”Upload grande demaisReduza o arquivo
“Nenhum quadro gravado…”GIF sem startPeça para iniciar a gravação antes
“Falha ao gerar o GIF (offscreen indisponível).”Documento offscreen não subiuRecarregue a extensão
Erro 403 nas ferramentasToken do relay desatualizadoApague ~/.cache/opencode-browser/relay.json (ou em $XDG_RUNTIME_DIR/opencode-browser/) e reinicie o OpenCode

15. Limites e privacidade


16. Referência rápida

Caminhos

O quêOnde
Build da extensãodist/ (é a pasta a carregar no Chrome)
Plugin e agente~/.config/opencode/plugins/
Conversas do navegador~/.opencode-browser-extensions
Capturas do agente~/.cache/opencode-browser/capturas/
Token e porta do relay$XDG_RUNTIME_DIR/opencode-browser/relay.json ou ~/.cache/opencode-browser/relay.json

Comandos úteis

npm run build              # gera dist/
npm run install:plugin     # copia plugin e agente
opencode service restart   # recarrega plugin e agente
opencode pair              # gera o link de pareamento
curl http://127.0.0.1:8799/health

Pedidos que funcionam bem