opencode-browser-tool-installer/docs/INSTALACION_POR_AGENTE.md

Instalacion por agente (flujo recomendado)

Objetivo: que el usuario solo haga git clone, abra OpenCode y pida al agente ejecutar esta guia.

Regla: el usuario no debe dar instrucciones adicionales.

Flujo de usuario (minimo)

1. Clonar el repo.
2. Abrir OpenCode en la carpeta del proyecto clonado.
3. Pedir al agente: "Lee docs/INSTALACION_POR_AGENTE.md y ejecuta la instalacion completa".

Nada mas.

Instrucciones para el agente OpenCode (ejecutar en orden)

1. Verificar entorno:

• comprobar node --version (Node 20+)
• comprobar npm --version

2. Ejecutar setup neutral:

npm run setup

3. Verificar instalacion:

./check.sh

4. Crear config MCP local del proyecto en .opencode/opencode.json usando ruta absoluta dinamica:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "browser-tool": {
      "type": "local",
      "command": [
        "node",
        "<ABSOLUTE_PATH>/dist/server.js"
      ]
    }
  }
}

Donde <ABSOLUTE_PATH> es la ruta real de la carpeta clonada (obtenida con pwd).

5. Confirmar conexion MCP:

opencode mcp list

Resultado esperado: browser-tool conectado.

6. Smoke test minimo con la tool:

• abrir navegador visible
• navegar a https://example.com
• tomar snapshot con label install-smoke
• cerrar navegador

7. Entregar resumen al usuario:

• estado final (ok/fallo)
• ruta usada en .opencode/opencode.json
• evidencia de snapshot en artifacts/

8. Politica de interaccion (obligatoria):

• no pedir al usuario pasos extra
• ejecutar toda la instalacion de forma autonoma
• solo pedir aclaracion si hay bloqueo real no resoluble por el agente (por ejemplo: falta Node.js en el sistema o permisos insuficientes)

Frase unica que debe usar el usuario

Lee y ejecuta docs/INSTALACION_POR_AGENTE.md