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）モードをサポートします。