agentcookie: sincroniza sesiones de Chrome con el equipo de tu agente
Evita repetir inicios de sesión en el equipo donde trabaja tu agente. Puedes sincronizar cookies de Chrome entre máquinas de confianza por Tailscale, con excepciones para sesiones vinculadas al dispositivo.
✓ verificado el 26 oct 2026
Instrucciones para tu agente
Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.
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.
Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
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:
mkdir -p ~/.config/agentcookie
En el origen, desde una carpeta que contenga la copia agentcookie del repositorio:
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:
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:
agentcookie sink
La guía documenta una sincronización puntual desde el origen:
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:
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
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.
agentcookie sincroniza cookies y ciertos secretos entre una máquina de origen y equipos donde se ejecutan agentes. El README actual describe origen en Mac, destinos Linux y otro Mac, y una ruta de origen Linux mediante CDP.
Para qué te sirve
Cuando tu agente usa Chrome en un segundo Mac y necesita una cuenta que ya has abierto.
Cuando una automatización de navegador corre en Linux y quieres sincronizar una sesión autorizada.
Cuando necesitas limitar la sincronización a dominios concretos en un destino menos confiable.
Cómo funciona
Los equipos se emparejan y el origen cifra los datos por destinatario sobre la conexión de Tailscale. Las políticas de dominios filtran qué se transmite. En Linux, la integración inyecta cookies en Chrome mediante CDP; no depende de reescribir su base SQLite. En macOS hay otras superficies de entrega, incluido un almacén en texto plano.
Antes de empezar
Necesitas Tailscale, Chrome y control de ambos equipos. El origen Mac accede al llavero para leer las cookies. El destino Linux necesita un Chrome con depuración local accesible por CDP. Revisa qué sesiones y secretos entregas al destino; una sesión autenticada representa capacidad de actuar en tu cuenta.
Repositorio activo comprobado con GitHub el 26 oct 2026; último commit consultado del 2026-10-15.
Límites y alternativas
No todas las sesiones son transferibles: las de Google protegidas por DBSC requieren iniciar sesión en el destino. El cifrado de transporte no elimina el riesgo de un equipo destino comprometido ni del almacén local en texto plano. La documentación tiene apartados de estado con información contradictoria sobre varios destinos; esta guía usa un solo par. Comprueba la entrega en Chrome con un sitio de prueba antes de activar la sincronización continua.
Recursos
Repo en GitHub - 859 estrellas; licencia de GitHub: MIT.
README consultado - funciones e instalación de la revisión consultada.
