sessfork-browser
Enables Arc to be used as the source browser for sessfork, extracting live cookies and localStorage from its profile and forking them into a headless Playwright browser session.
Enables Brave to be used as the source browser for sessfork, extracting live cookies and localStorage from its profile and forking them into a headless Playwright browser session.
Enables forking a signed-in GitHub session into a headless browser so an agent can check notifications and review PR/CI status without disturbing the active Chrome window.
Enables forking a signed-in Google Cloud Console session (console.cloud.google.com) from a selected browser profile into a headless browser for authenticated access.
Enables forking a signed-in Linear session into a headless browser so agents can summarize assigned sprint tasks and blockers in the background.
Enables forking a signed-in Notion session into a headless browser for background access to workspace pages and tasks.
Enables forking a signed-in Supabase dashboard session using localStorage-only mode (--no-cookies) for authenticated dashboard and API verification.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sessfork-browser check my unread GitHub notifications without switching tabs"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
sessfork
English · 简体中文 · Interactive Visual Guide
Fork live Chrome auth sessions (Cookies + LocalStorage) into headless AI agent browsers — zero window focus theft, zero runtime dependencies.
When AI coding agents (Google Antigravity, Claude Code, or Cursor) connect directly to your main Chrome instance to reuse logged-in sessions, they hijack your active window, switch tabs, and break your flow.
sessfork decouples your UI viewport from browser auth state in a single command: it takes lock-free snapshots of your live Chromium SQLite Cookies database and LevelDB Local Storage/leveldb store, decrypts cookies in memory via native OS APIs, reconciles MVCC sequence numbers for SPA/JWT localStorage tokens, writes a strict 0600 Playwright storageState file, and wires a silent background Playwright MCP server (sessfork-browser) across your installed AI agents.
10-Second Lazy Quickstart
Install once, then just talk to your AI agent in plain language.
Option A · One-Click Auto-Setup (Recommended — zero prerequisites)
Auto-detects installed AI tools (Antigravity, Claude Code, Cursor), registers the background sessfork-browser MCP server, and installs the global Agent SKILL.md:
curl -fsSL https://raw.githubusercontent.com/wasabihu/sessfork/main/install.sh | bashWant to fork your first domains in the very same command? Pass them right after --:
curl -fsSL https://raw.githubusercontent.com/wasabihu/sessfork/main/install.sh | bash -s -- github.com linear.app(Note: On each cookie fork, macOS asks to read "Chrome Safe Storage" from Keychain — click Allow. For pure LocalStorage JWT sites, pass --no-cookies for zero Keychain prompts. See the FAQ for the opt-in --cache-key.)
Option B · Zero-Install One-Shot (uvx)
Try sessfork immediately without touching global binaries:
uvx --from git+https://github.com/wasabihu/sessfork sessfork github.comOption C · Global uv tool or Editable Local Checkout
# Install globally via uv
uv tool install git+https://github.com/wasabihu/sessfork.git
# Or clone locally
git clone https://github.com/wasabihu/sessfork.git
cd sessfork
uv tool install -e .(Tip: Once installed, reload MCP servers once in your AI editor or run /mcp in CLI so sessfork-browser becomes active.)
Related MCP server: Browser MCP
5 Real-World Copy-Paste Examples
Once installed, you don't even have to remember CLI flags. Copy any prompt below straight to your AI agent — or run the 1-line command directly.
1. Triage GitHub PRs & CI Failures Silently
Copy & paste to your AI Agent: "Use
sessforkto fork mygithub.comlogin session intosessfork-browser, then silently check my unread notifications and review the failing PR checks without switching or touching my active Chrome window."
sessfork github.com2. Check Linear / Notion / Jira Sprint Tasks
Copy & paste to your AI Agent: "Fork my
linear.appandnotion.sosessions withsessforkand summarize today's assigned sprint blockers in the background."
sessfork linear.app notion.so3. Pure SPA / JWT Apps & Localhost (Zero Keychain Prompt)
Modern SPAs (Supabase, Vercel dashboards, local dev apps) store bearer tokens in localStorage instead of HttpOnly cookies. Skip Keychain completely with --no-cookies:
Copy & paste to your AI Agent: "Run
sessfork app.supabase.com localhost:3000 --no-cookiesand verify the authenticated dashboard API responses insessfork-browser."
sessfork app.supabase.com localhost:3000 --no-cookies4. Paste Full URLs Straight from Your Address Bar
Don't bother stripping https:// or paths — sessfork automatically normalizes full URLs to their domain allowlist:
sessfork https://github.com/notifications5. Fork from Arc, Brave, Edge, or a Specific Work Profile
sessfork supports chrome, canary, brave, edge, and arc, and automatically discovers your most recently active profile (or lets you target one explicitly):
sessfork x.com --browser arc
sessfork console.cloud.google.com --profile "Profile 1"Architecture & Highlights
Zero Runtime Dependencies: Pure Python standard library (
>=3.9). Uses macOSCommonCrypto(/usr/lib/libSystem.B.dylibviactypes) for AES-128-CBC cookie decryption (andopensslCLI on Linux) plus a built-in pure-Python LevelDB SSTable/WAL + Snappy reader.Full Dual-Layer Auth (
Cookies+LocalStorage):SQLite Cookies: Handles Chromium Cookie DB
meta.version >= 24(SHA-256(host_key)32-byte plaintext prefix stripping), live-wal/-shmsidecars, andSameSite/HttpOnlyfidelity.LevelDB LocalStorage (
origins): Parses Chromium's_<origin>\x00encoding-prefixed (0x00UTF-16LE /0x01Latin-1) records across.ldbSSTables and.logWALs, honoringkTypeDeletiontombstones (localStorage.removeItem) so logged-out JWTs are never resurrected.
One-Command Auto-Wiring:
sessfork <domain>andsessfork --setupauto-detect Antigravity, Claude Code, and Cursor (--target auto), resolve absolutenpxpaths (avoiding macOS GUI$PATHlaunch failures), and installSKILL.md.
Cheat Sheet
Goal | Command |
One-time setup (MCP + Skill for all detected agents) |
|
Fork Cookies + LocalStorage for domains |
|
Fork LocalStorage JWT only (zero Keychain prompt) |
|
Fork SQLite Cookies only |
|
Choose source browser ( |
|
Target specific profile folder |
|
Wire Antigravity + Claude Code + Cursor explicitly |
|
Inspect cached domains & origins (redacted, safe) |
|
Re-fork all domains currently saved in |
|
Opt-in: cache the derived key to skip future Keychain prompts (see FAQ) |
|
Force re-read the key from Keychain (e.g. after Chrome rotated it) |
|
Delete any cached derived keys |
|
Remove cached state for specific domain (or all) |
|
FAQ
Dedicated AI browsers (like ego-lite) ship a separate Chromium desktop app with built-in workspaces and import your Chrome profile so agents can act visually alongside you. sessfork takes a deliberately lighter, least-privilege approach:
Keep your existing browser: No second desktop browser to install, maintain, or migrate to — keep using your native Chrome, Arc, Brave, or Edge as usual.
Domain-scoped isolation (least privilege): Instead of handing an AI browser your entire profile (banking, primary email, corporate SSO, extensions, and all open tabs),
sessforkforks only the exact domains you allowlist (e.g.sessfork github.com linear.app) into a one-way0600snapshot.Standard Playwright ecosystem: Outputs standard Playwright
storageStateJSON, so it plugs straight into official@playwright/mcpas well as your own Playwright scripts and headless automation pipelines.
Choose a dedicated AI browser if you want a visual cursor watching the agent click or routinely deal with heavy headed anti-bot flows; choose sessfork if you want a zero-dependency CLI that keeps your main browser untouched and exposes only selected domains to a silent headless agent.
Chromium encrypts cookie values using a master passphrase stored under "Chrome Safe Storage" in your macOS Keychain. Click Allow so macOS authorizes security to read that entry. If a site uses localStorage tokens (many modern SPAs), pass --no-cookies to bypass Keychain completely.
By default sessfork does not store the derived decryption key anywhere, so macOS stays in charge of every authorization. If you prefer convenience, --cache-key saves the derived key to ~/.sessfork/keys.json (0600). Trade-off: any process running under your user account could then read that file and decrypt your Chrome cookies without a Keychain prompt. Run sessfork --purge-keys to remove it at any time.
macOS: fully supported and tested on real Chrome profiles.
Linux: experimental — covered by unit tests, but not yet verified against many real-world Chrome/Secret Service setups. Bug reports welcome.
Windows: not supported (Chromium on Windows uses DPAPI / app-bound encryption).
Chromium batches localStorage flushes from memory to LevelDB on disk roughly every 5 seconds. Wait ~5 seconds after signing in and re-run sessfork <domain>.
Run sessfork --clear <domain> to purge a single site, or sessfork --clear (or rm -rf ~/.sessfork) to wipe all cached session state.
No — only reload MCP once right after initial installation. Whenever you run sessfork <domain> or sessfork --refresh, sessfork updates an atomic 0600 mirror at ~/.sessfork/playwright-output/.sessfork-state.json inside Playwright MCP's --output-dir sandbox, and your AI agent hot-reloads it straight into the running sessfork-browser via browser_set_storage_state with zero restarts.
Security & Responsible Use
Domain Allowlist by Default: Only the domains/origins you explicitly name are extracted.
Strict File Permissions:
~/.sessfork/is0700and~/.sessfork/state.jsonis atomically created with0600permissions before a single byte is written.Redacted Diagnostics:
sessfork --status,--json, andSKILL.mdnever print raw cookie or LocalStorage values to stdout or agent prompt context.No Key Persistence by Default: The derived cookie key lives only in memory for the duration of one command. Persisting it (
--cache-key) is an explicit opt-in.Isolated Headless Browser:
sessfork-browserruns@playwright/mcp --headless --isolated, so each MCP session starts from the forkedstate.jsoninstead of a persistent profile. Page snapshots and screenshots go to~/.sessfork/playwright-output/(--output-dir), never into a.playwright-mcp/folder inside your projects.Responsible Use:
sessforkoperates strictly within your signed-in OS user account and relies on native OS keyring authorization (macOS Keychain / Linux Secret Service) — it never bypasses OS access controls or sandboxes. Use it only on devices and accounts you own or are explicitly authorized to test, and always comply with target websites' Terms of Service.Reporting Vulnerabilities: See SECURITY.md.
Development & Tests
PYTHONPATH=src python3 -m unittest discover -s tests -vLicense
Available Tools
25 toolsbrowser_clickBDestructive
Perform click on a web page
Inputs: target (required), button, element, modifiers, +1 more.
browser_closeADestructive
Close the browser and all open tabs.
Inputs: no named parameters.
browser_console_messagesCRead-only
Returns all console messages
Inputs: level (required), all, filename.
browser_dragADestructive
Perform drag and drop between two elements
Inputs: endTarget (required), startTarget (required), endElement, startElement.
browser_dropADestructive
Drop files or MIME-typed data onto an element, as if dragged from outside the page. At least one of "paths" or "data" must be provided.
Inputs: target (required), data, paths, element.
browser_emulate_mediaADestructive
Emulate CSS media features for the page, for example switch between the light and dark color scheme. Omitted parameters are left unchanged; null clears an override.
Inputs: media, contrast, colorScheme, forcedColors, +1 more.
browser_evaluateCDestructive
Evaluate JavaScript expression on page or element
Inputs: function (required), target, element, filename.
browser_file_uploadBDestructive
Upload one or multiple files
Inputs: paths.
browser_fill_formBDestructive
Fill multiple form fields
Inputs: fields (required).
browser_findARead-only
Search the accessibility snapshot of the current page for text or a regular expression. Returns matching snapshot nodes with a few lines of surrounding context (like search snippets), each shown under its path from the root of the tree, which is cheaper than capturing the whole snapshot when you only need to locate an element and its ref.
Inputs: text, regex, filename, maxResults.
browser_handle_dialogCDestructive
Handle a dialog
Inputs: accept (required), promptText.
browser_hoverADestructive
Hover over element on page
Inputs: target (required), element.
browser_network_requestARead-only
Returns full details (headers and body) of a single network request, or a single part if part is set. Use the number from browser_network_requests.
Inputs: index (required), part, filename.
browser_network_requestsARead-only
Returns a numbered list of network requests since loading the page. Use browser_network_request with the number to get full details.
Inputs: static (required), all, filter, filename.
browser_press_keyBDestructive
Press a key on the keyboard
Inputs: key (required).
browser_resizeBDestructive
Resize the browser window
Inputs: width (required), height (required).
browser_run_code_unsafeADestructive
Run a Playwright code snippet. Unsafe: executes arbitrary JavaScript in the Playwright server process and is RCE-equivalent.
Inputs: code, filename.
browser_select_optionBDestructive
Select an option in a dropdown
Inputs: target (required), values (required), element.
browser_snapshotARead-only
Capture accessibility snapshot of the current page, this is better than screenshot
Inputs: boxes, depth, target, filename.
browser_tabsCDestructive
List, create, close, or select a browser tab.
Inputs: action (required), url, index, isolatedContext.
browser_take_screenshotARead-only
Take a screenshot of the current page. Use browser_snapshot for actions by default. With the vision capability enabled, use screenshot coordinates with the coordinate-based mouse tools for elements not exposed in the accessibility snapshot.
Inputs: scale (required), type, target, element, +2 more.
browser_typeBDestructive
Type text into editable element
Inputs: text (required), target (required), slowly, submit, +1 more.
browser_wait_forARead-only
Wait for text to appear or disappear or a specified time to pass. When both text and textGone are provided, waits for the first one to happen
Inputs: text, time, textGone.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Each tool maps to a fairly distinct browser action, and the descriptions actively disambiguate tricky pairs (snapshot vs screenshot, find vs snapshot, network_requests vs network_request). Minor overlap remains between browser_run_code_unsafe and the specialized tools, and between browser_type/browser_fill_form, but the guidance is clear enough to choose correctly.
Every tool uses the same browser_<snake_case_action> convention with predictable verb or noun phrasing. The singular/plural pair browser_network_requests and browser_network_request is intentional and documented, not an inconsistency.
25 tools is at the heavy end for the stated scope; while browser automation is inherently broad, several low-frequency capabilities (drop, emulate_media, resize, run_code_unsafe) push the surface toward the ceiling. It is workable but feels padded rather than tightly scoped.
Core lifecycle coverage is strong: navigation, interaction, forms, tabs, network, console, screenshots, and dialogs are all present. Gaps are minor but real — no forward navigation counterpart to browser_navigate_back, and no explicit cookie/storage or download handling, though browser_evaluate and browser_run_code_unsafe can work around these.
Maintenance
Related MCP Connectors
Let AI agents use any website you're logged in to. Sessions stay encrypted on your machine.
Let your AI agent operate any website through a real, logged-in browser session.
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with a user's real Chrome browser tabs, executing JavaScript, reading cookies, and making fetch requests within authenticated sessions.-
- AlicenseAqualityAmaintenanceEnables AI agents to drive your real, logged-in Chrome browser with existing sessions and cookies, bypassing CAPTCHA and anti-bot measures, with support for multi-session and human-in-the-loop workflows.4066MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to securely control a user's existing signed-in Chrome browser through isolated tab groups, with strict per-session ownership and no cookie or token exposure.-
- AlicenseAqualityCmaintenanceEnables AI agents to access authenticated websites by reusing your existing browser profile and cookies, so you never share passwords and sessions persist between runs.55MIT