README.md

March 26, 2026 · View on GitHub

Plasmate

Plasmate Cookie Export

Chrome extension for exporting auth cookies to Plasmate.
One click. No dev tools.

Website · Docs · Engine

License Manifest V3 Minimal Permissions


Agents need authenticated access to sites like X, GitHub, and LinkedIn. But automated login triggers bot detection. The solution: you log in normally, then hand the cookies to Plasmate.

This extension makes that handoff instant.

How It Works

  1. Navigate to a site and log in normally
  2. Click the Plasmate icon in the toolbar
  3. Auth cookies are pre-selected for known sites
  4. Click Push to Plasmate (or copy to clipboard as fallback)

The fastest way: run the Plasmate bridge server and cookies get pushed directly with one click. No copy-paste needed.

# Start the bridge server (runs on 127.0.0.1:9271)
plasmate auth serve

When the bridge is running, the extension shows a green dot with the version number. Click Push to Plasmate and cookies are stored instantly with AES-256-GCM encryption.

When the bridge is offline, the extension shows "Bridge offline" and falls back to copying a CLI command to your clipboard.

The extension sends each cookie's expirationDate from Chrome's cookie API. Plasmate tracks expiry so you get warnings when cookies are about to expire:

# Check cookie status
plasmate auth list
# ✓ x.com (2 cookies) - valid
# ⚠ github.com (2 cookies) - expires soon

plasmate auth info x.com
# Domain:    x.com
# Cookies:   2
# Encrypted: yes
#   ct0 - ✓ valid (expires in 14 days)
#   auth_token - ✓ valid (expires in 30 days)

Manual Mode (No Bridge)

If you prefer not to run the bridge, the extension copies CLI commands to your clipboard:

Copy CLI:

plasmate auth set x.com --cookies "ct0=abc123; auth_token=xyz789"

Copy JSON:

{
  "domain": "x.com",
  "cookies": {
    "ct0": "abc123",
    "auth_token": "xyz789"
  },
  "expiry": {
    "ct0": 1742500000,
    "auth_token": 1745000000
  }
}

Install

Chrome Web Store listing coming soon. For now, install via developer mode.

  1. Clone this repo
  2. Open chrome://extensions/
  3. Enable Developer mode (top right toggle)
  4. Click Load unpacked and select this directory

Supported Sites

Pre-configured cookie recommendations for popular platforms:

SiteCookies
X / Twitterct0, auth_token
GitHubuser_session, __Host-user_session_same_site
LinkedInli_at, JSESSIONID
Redditreddit_session, token_v2
Instagramsessionid, csrftoken

Every site works. These just get auto-selected for convenience.

Privacy & Security

  • Permissions: cookies, activeTab, host_permissions (needed for cross-domain cookie access in MV3)
  • Local only: the extension only communicates with 127.0.0.1:9271 (the local Plasmate bridge). It never contacts any external server.
  • No storage: nothing persisted in the extension itself
  • No analytics: no tracking, no telemetry
  • Encrypted at rest: cookies pushed via the bridge are encrypted with AES-256-GCM before being written to disk
  • Open source: read every line, it's ~200 lines of JS

License

MPL-2.0 - Modifications to these files must stay open. Use freely in any project.


Part of the Plasmate Ecosystem

Engineplasmate - The browser engine for agents
MCPplasmate-mcp - Claude Code, Cursor, Windsurf
Extensionplasmate-extension - Chrome cookie export
SDKsPython / Node.js / Go / Rust
FrameworksLangChain / CrewAI / AutoGen / Smolagents
ToolsScrapy / Audit / A11y / GitHub Action
ResourcesAwesome Plasmate / Notebooks / Benchmarks
Docsdocs.plasmate.app
W3CWeb Content Browser for AI Agents