# Instrucciones para el agente: agentcookie: sincroniza sesiones de Chrome con el equipo de tu agente

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: avanzado
- Proyecto: https://github.com/mvanhorn/agentcookie (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/agentcookie

---

## 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 dos Mac de confianza

Sigue docs/quickstart.md para esta ruta. Necesitas Tailscale conectado y Chrome estable en ambos equipos. Instala el binario para cada arquitectura desde Releases y comprueba su checksum. La alternativa de compilación de esa guía requiere Go 1.24 o posterior.

### Paso 2: prepara las configuraciones

Descarga el repositorio oficial para disponer de examples/ y crea la carpeta de configuración en ambos equipos. La guía documenta:

```text
mkdir -p ~/.config/agentcookie
```

En el origen, desde una carpeta que contenga la copia agentcookie del repositorio:

```text
cp agentcookie/examples/source.yaml ~/.config/agentcookie/source.yaml
cp agentcookie/examples/blocklist.yaml ~/.config/agentcookie/blocklist.yaml
```

En el destino, desde una carpeta que contenga su propia copia del repositorio:

```text
cp agentcookie/examples/sink.yaml ~/.config/agentcookie/sink.yaml
cp agentcookie/examples/blocklist.yaml ~/.config/agentcookie/blocklist.yaml
```

Edita los archivos según la guía: URL y hostname del destino en el origen; dirección Tailscale y hostname del origen en el destino. Usa una política `allowlist` (lista de permitidos) con los hosts exactos que autorizas. Una `blocklist` (lista de bloqueados) vacía sincroniza todo, por lo que no es una prueba limitada.

### Paso 3: empareja las máquinas

En el origen, el comando oficial es:

```text
agentcookie pair --as source
```

Usa en el destino la instrucción de emparejamiento que genera, sustituyendo la URL por el hostname Tailscale real del origen según quickstart.md. No uses 0.0.0.0 como dirección del otro equipo. Conserva el código en privado y comprueba que ambos lados muestran la misma huella.

### Paso 4: prueba una sincronización

En el destino, inicia el proceso interactivo:

```text
agentcookie sink
```

La guía documenta una sincronización puntual desde el origen:

```text
agentcookie source --once --verbose
```

Revisa los diagnósticos localmente sin copiarlos al chat. Para que la prueba llegue a Chrome en el Mac destino, adapta `sink.yaml`: el ejemplo actual está preparado para Linux, aunque quickstart describe un par de Mac. Desactiva `live_cdp.enabled` y añade la opción macOS documentada al final del [ejemplo de configuración](https://github.com/mvanhorn/agentcookie/blob/main/examples/sink.yaml):

```yaml
cdp:
  enabled: true
  managed: true
```

Esto inicia un Chrome administrado con perfil propio. Verifica la sesión en ese Chrome, que recibe las cookies, y no en tu navegador habitual. Mantén el puerto de depuración restringido al propio equipo. Configura esta opción antes de iniciar `agentcookie sink` y sincronizar.

### Paso 5: activa continuidad si la prueba funciona

```text
agentcookie source --watch
```

Mantén el destino ejecutándose. Para Linux, sigue el recorrido separado del README; su configuración e inyección de cookies son distintas.

## Comprobación

Abre un sitio autorizado de prueba en el Chrome del destino y comprueba el estado de sesión. Puedes revisar `agentcookie status` y `agentcookie doctor`. No imprimas cookies ni uses `cookies --json`. Una copia en el almacén local no demuestra que Chrome reciba la sesión.

## Si algo falla

Comprueba la política de hosts, el emparejamiento y la conectividad Tailscale. Si falla Google, revisa DBSC y realiza el inicio de sesión humano en ese equipo. No amplíes todos los dominios para depurar un sitio. El README contiene apartados de estado contradictorios sobre varios destinos; esta prueba usa un solo par.

Fuente: [quickstart oficial](https://github.com/mvanhorn/agentcookie/blob/HEAD/docs/quickstart.md) y [README](https://github.com/mvanhorn/agentcookie/blob/HEAD/README.md).