paco/opencode-browser-tool-installer
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Tool para agentes de IA, que permite lanzar un navegador y que el agente pueda realizar actuaciones como un humano, de forma que permite usar la tool al agente para probar los desarrollos y obtener toda la informacion de la ejecucion, logs, variables, estado del dom, capturas de pantalla, incluso solicitar videos. Esta pensado para cualquier agente pero creado especialemente para opencode.
5 commits 1 branch 0 tags 136 KiB
TypeScript 70.5%
JavaScript 23.5%
HTML 4.4%
Shell 1.6%
Find a file
Exact
Paco 059fe05e14 feat: add configurable user creation flow script
2026-04-25 19:52:13 +02:00
config chore: initialize browser tool devlog from project root 2026-04-24 23:59:41 +02:00
docs docs: enforce single-command agent installation flow 2026-04-25 00:31:09 +02:00
scripts feat: add configurable user creation flow script 2026-04-25 19:52:13 +02:00
src chore: initialize browser tool devlog from project root 2026-04-24 23:59:41 +02:00
.gitignore chore: initialize browser tool devlog from project root 2026-04-24 23:59:41 +02:00
check.sh chore: harden installer workflow and setup docs 2026-04-25 00:20:38 +02:00
install.sh chore: harden installer workflow and setup docs 2026-04-25 00:20:38 +02:00
opencode.mcp.example.json chore: harden installer workflow and setup docs 2026-04-25 00:20:38 +02:00
package-lock.json chore: initialize browser tool devlog from project root 2026-04-24 23:59:41 +02:00
package.json chore: harden installer workflow and setup docs 2026-04-25 00:20:38 +02:00
README.md docs: add agent-driven installation workflow 2026-04-25 00:26:01 +02:00
tsconfig.json chore: initialize browser tool devlog from project root 2026-04-24 23:59:41 +02:00

README.md

OpenCode Browser Tool

Herramienta browser externa para OpenCode, pensada para navegar e interactuar con aplicaciones web desde un navegador real controlado por Playwright + Chromium, con integracion por MCP.

Estado actual

Proyecto en preparacion de la v1.

La prioridad actual es lograr una integracion efectiva entre OpenCode y el browser manteniendo la solucion totalmente desacoplada del core de OpenCode.

Onboarding recomendado para agentes nuevos

Al iniciar una sesion en un equipo nuevo, pide primero:

  • browser_help para descubrir capacidades, defaults y ejemplos
  • browser_health para ver estado operativo, actividad y artifacts recientes

Default relevante en v1:

  • browser_report usa saveToFile=true por defecto (configurable de forma persistente con browser_config)

Objetivo de la v1

  • exponer una tool browser externa por MCP
  • abrir Chromium en modo visible por defecto
  • permitir navegacion e interaccion base con apps locales
  • recoger evidencia minima util para diagnostico

Stack fijado para la v1

  • Node.js 20+
  • TypeScript
  • Playwright
  • Chromium
  • MCP por stdio

Modos de navegador en runtime

  • testing: navegador gestionado por Playwright (default)
  • system: navegador del sistema (ej. /usr/bin/google-chrome)

Ambos modos pueden abrir con perfil efimero o perfil persistente (userDataDir) segun configuracion y parametros de browser_open.

Defaults operativos relevantes:

  • recordVideo=false (grabacion bajo demanda)
  • verbose=true y verboseOverlay=true en modo visible
  • delay humano de interaccion 1000-3000ms para acciones click-like

Estructura actual

opencode-browser-tool/
  artifacts/
  config/
  docs/
  scripts/
  src/
    browser/
    tools/
    types/
  check.sh
  install.sh
  opencode.mcp.example.json
  package.json
  README.md
  tsconfig.json

Documentacion principal

  • docs/PLAN_DE_DESARROLLO.md
  • docs/TODO.md
  • docs/manual_de_uso_heramienta.md
  • docs/QUICKSTART.md
  • docs/VALIDACION_ENTORNO_LIMPIO.md
  • docs/PLAN_CIERRE_INSTALABLE.md
  • docs/INSTALACION_WINDOWS.md
  • docs/INSTALACION_POR_AGENTE.md
  • docs/REGISTRO_SITUACIONES.md
  • docs/contexto_workspace/ (snapshot de docs globales clave para continuidad)

Instalacion prevista

La idea es que este proyecto pueda copiarse o descargarse en un PC con OpenCode y dejarse listo mediante:

  • ./install.sh
  • npm run setup (alternativa neutral por npm/node)
  • una guia de instalacion clara
  • o instrucciones que un agente de OpenCode pueda ejecutar

Flujo recomendado para operario (minimo manual):

  1. git clone ...
  2. abrir OpenCode en esa carpeta
  3. pedir al agente que siga docs/INSTALACION_POR_AGENTE.md

Que hace el setup

El setup ejecuta, en orden:

  • validacion de Node.js 20+
  • instalacion de dependencias (npm ci cuando hay lockfile)
  • compilacion (npm run build)
  • instalacion de Chromium managed by Playwright

Al terminar, muestra un snippet MCP con la ruta absoluta local de dist/server.js.

Verificacion

Tras instalar, ejecutar:

  • ./check.sh o npm run check

La verificacion recompila y confirma archivos clave para puesta en marcha en otro PC.

Nota

Este proyecto debe seguir siendo externo a OpenCode para que las actualizaciones del propio OpenCode no afecten a esta herramienta.