mvanhorn/agentcookie

해결하는 문제

AI 에이전트가 실행되는 원격 서버나 VM에서 웹사이트에 수동으로 로그인할 필요가 사라집니다. 헤드리스 Linux 박스에서 반복적으로 쿠키를 붙여넣거나 수동 인증 절차를 수행할 필요 없이, 이 도구는 로컬 Mac에서 활성 브라우저 세션을 원격 에이전트 환경으로 지속적으로 동기화합니다.

작동 방식

agentcookie는 보안적인 Tailscale 네트워크를 통해 소스-싱크 아키텍처를 사용합니다:

1. 소스 (Mac): Chrome의 쿠키 파일 변경을 모니터링하고, macOS Keychain을 사용해 복호화하며, 사용자 정의 정책에 따라 필터링한 후 AES-256-GCM로 암호화하여 전송합니다.
2. 싱크 (Linux/Mac): 암호화된 쿠키를 수신하고 Chrome DevTools Protocol (CDP)를 사용해 원격 Chrome 인스턴스의 메모리 내 저장소에 직접 삽입합니다.

실시간 CDP 주입을 사용하기 때문에, 브라우저 데이터베이스 파일을 디스크에 다시 쓰는 것 없이도 원격 브라우저 세션이 실시간으로 업데이트됩니다.

대상 사용자

리모트 Linux VM, 클라우드 런타임, 또는 홈랩 서버에서 browser-use, Puppeteer, Playwright 등의 프레임워크를 사용해 브라우저 기반 에이전트를 운영하는 개발자 및 AI 연구자로, 에이전트가 자신의 인증된 웹 세션을 상속받고 싶은 분들입니다.

주요 특징

• 지속적 동기화: 소스 기기에서 쿠키가 변경되는 즉시 차이점을 자동으로 전송합니다.
• 인증 절차 없음: 수동 로그인 단계 없이 즉시 인증된 페이지에 접근할 수 있습니다.
• 보안 전송: Tailscale의 WireGuard 채널과 AES-256-GCM 암호화를 사용해 데이터 전송을 보호합니다.
• 실시간 CDP 주입: Linux에서 Keychain이나 SQLite 재작성 없이 메모리에 직접 쿠키를 삽입하여 필요 없는 작업을 회피합니다.
• 유연한 정책: 허용 목록(allowlist) 및 차단 목록(blocklist) 모드를 지원해 동기화할 도메인을 제어할 수 있습니다.