mcp server
pairbrowse
Multiplayer browser sessions for developers and AI coding agents
Set up
Runs on your computer. Pick your agent and operating system.
This project does not publish an install method we can turn into a config. Follow the README instead.
README
synced Oct 17, 2026PairBrowse
Work in one live browser with your AI agent and your team. Claude Code or Codex drives the tabs, teammates join from their own computers with their own cursor and their own agent, and you step in whenever you like. Sites see an everyday browser, not an automated one.
- Built for working together. Send a watch or drive code: a teammate sees the same tabs live, clicks and types with their own cursor, and their Claude or Codex can work in another tab of the same session. Pause every agent at once with one click.
- Stealth browser with a real fingerprint. A hardened browser driven through Patchright instead of stock Playwright: no automation flag, AutomationControlled off, no debugging port. On a Mac the fingerprint is captured from your own machine and kept per profile, so the GPU and WebGL it reports, time zone and language match real hardware. Clicks and typing follow human timing and curved mouse paths. Fewer CAPTCHAs, fewer "unusual activity" blocks.
- Fast, accurate forms. Fast mode fills a whole page (fields, dropdowns, checkboxes, Next) in one action from the page's accessibility tree, then checks a screenshot for what the tree can't show. Remembered details mean no retyping; Pay, delete, publish and send still wait for you.
- Separate from your everyday browser, but it remembers. Logins persist in their own profile, one per client if you like. Passwords are filled only on the sites you allow and never shown to the model. Half-finished jobs resume tomorrow.
Install
claude plugin marketplace add pairbrowse/pairbrowse
claude plugin install pairbrowse@pairbrowse
Restart Claude Code. Needs Node.js 20+ and Claude Code running on your computer (not a cloud session). Codex: see docs/codex.md. Grok uses the Claude Code install as it is: see docs/grok.md. Update, uninstall and a local checkout: docs/install.md.
Two ways to run it: the native build or the open build
- The native PairBrowse browser (the default on a Mac, Apple Silicon or Intel, and on Linux x64). A hardened build made for PairBrowse, with its own tab strip, docks, new tab page and Settings built in, and pointers of the people who joined drawn by the browser itself. It looks like an everyday browser to sites, so you see fewer CAPTCHAs.
- PairBrowse (open build), for people who'd rather have the classic browser menus, settings and toolbar: the fully open-source browser with PairBrowse as an extension in it: the side panel (Cmd+Shift+Y, Ctrl+Shift+Y off a Mac), its toolbar menu, Settings, and the downloads, recordings and hand-offs lists. Fully open source, so it's also the choice for commercial use without a Pro license. Windows uses this until the native build arrives.
Pick one with "browser" in ~/.pairbrowse/config.json: "pairbrowse" (native) or
"pairbrowse-open" (open build; the older "chromium" still works); PairBrowse asks once, and
Settings can switch it. Everything else (agents, sharing,
sessions, safety) works the same in both. Details: The browser.
Try it
Register a Shopify Partner account for our company and start an app listing for our app.
The first run downloads the browser (about 150 MB) and opens it. Sign into the sites you need once; they stay signed in.
Work together, through your own tunnel if you like
Invite a colleague to watch or co-drive, or share one browser between two computers with a join
code (pairbrowse_invite, pairbrowse_join). Out of the box the connection goes through a free
Cloudflare Quick Tunnel: no account, a random address each time. If you would rather use your own
address and account, set it once in ~/.pairbrowse/config.json and everything else stays the same:
"sharing": { "tunnel": { "kind": "ngrok", "authtoken": "...", "domain": "share.example.com" } }
kind can be quick (the default), cloudflare (a named tunnel with your token and hostname),
ngrok, tailscale (Funnel) or command (any program that prints a public URL). Your token stays
in that file and goes only to the provider's own program. Setup for each is in
Working together.
Compared with the built-in browsers
| Claude Code's browser extension | Codex browser | PairBrowse | |
|---|---|---|---|
| Browser it drives | Your everyday browser | Codex's own browser | Its own browser and profile |
| Resume a half-finished job another day | No saved runs | Sometimes; often the state is lost | Yes: saved runs, tabs and logins |
| Share a live session with a teammate and their agent | No | No | Yes |
| Works from both Claude Code and Codex | No | No | Yes |
Use the built-ins for a quick task in a site you're already signed into. Use PairBrowse for doing it together, long form work, sites that block automated browsers, or client accounts kept apart.
Safety
- No debugging port: the browser is driven over a private pipe, reachable only by your user.
- Pay, publish, delete, send and submit-for-review clicks ask you first; you can answer in the PairBrowse window or the terminal. Payments, danger buttons and deletions are found from the page's structure (card fields, payment frames, danger styling, HTTP DELETE), not its words; Claude or Codex names the other final actions from its task. Ordinary steps (Continue, Save, Next) don't interrupt you, and nothing is sent to another model or service. Publishing also needs a passing check against the platform's current rules.
- Passwords work only on the domains you list for them and are masked in everything the model reads.
- Join codes share tabs and form values, never your cookies, logins or passwords, and only after you click Allow.
- PairBrowse never solves CAPTCHAs or bot checks.
Full threat model and limits: docs/security.md. Report issues privately: SECURITY.md.
Intended use
Quick sign-ups, registrations and listings that come up while you build a product (developer accounts, app store listings, API keys, store settings), with you in the loop. Not for creating accounts in bulk, getting around a site's bot checks, or anything else a site doesn't allow. You use it on your own accounts and accept each site's terms.
Open source, honestly
The plugin and helper are MIT (LICENSE). On macOS and Linux x64 the default browser
setting ("pairbrowse") downloads the native PairBrowse browser, a closed build that's
free for personal, non-commercial use (BINARY-LICENSE.md). For commercial
use, either get a PairBrowse Pro license or set "browser": "pairbrowse-open" in
~/.pairbrowse/config.json for a fully open setup (PairBrowse (open build): a pinned open-source
build on macOS, Playwright's browser elsewhere). See docs/browser.md.
Docs
- What it does: features, how a run goes, design principles
- Install, Codex and Grok
- The browser: where you see it, the desktop app pane, the native build
- Using PairBrowse: remembered details, passwords, sessions, fast mode, popups, uploads
- Working together: invites, join codes, several agents on one browser, your own tunnel
- Skills
- Configuration
- Troubleshooting
- Security, the assurance case and reporting a vulnerability
- Architecture
- Development
- Changelog and Roadmap
Status
Early development. Expect breaking changes while the helper, collaboration model and agent integrations evolve, and treat the security model as still maturing.