# Instrucciones para el agente: BYOB: conecta tu agente con una sesión de Chrome existente

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/wxtsky/byob (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/byob-bring-your-own-browser

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: prepara la instalación

Comprueba que tienes Node.js ≥20 y Chrome, Edge o Brave disponibles, además de un cliente MCP. El asistente puede instalar Bun si falta. En Windows abre Git Bash o MSYS2.

El instalador oficial es:

```sh
curl -fsSL https://raw.githubusercontent.com/wxtsky/byob/main/install.sh | bash
```

### Paso 2: completa el asistente

Revisa los requisitos y selecciona solo los clientes necesarios. Carga la extensión descomprimida desde `~/byob/packages/extension/output/chrome-mv3` (o el directorio elegido) en `chrome://extensions`, con el modo de desarrollador activo. Cierra completamente Chrome y vuelve a abrirlo para que lea el registro de comunicación con el proceso local. Usa inicialmente un perfil de prueba.

## Comprobación

Comprueba que el cliente ve una pestaña de prueba y puede leer su título. Verifica el perfil conectado antes de usar una página con sesión iniciada.

## Si algo falla

Si no hay comunicación, revisa el registro del proceso local de conexión y la extensión configurada por el asistente. Si falta una herramienta en el cliente, comprueba MCP y recarga la sesión.