Many actions, one call
onbrowser_batch runs up to 20 actions in one call, stops at the first one that fails and returns one line per action.
tool browser_batch
Actionsturno-browser · Open source · Apache-2.0 · macOS and Linux
It stays light on your machine, and the model never sees your passwords.
An MCP server for Claude Code, Codex, Copilot CLI and Cursor CLI. It drives the Google Chrome you already have, with one persistent profile per identity.
Start from your problem
one profile per identity
Each identity is a real Chrome profile on your machine. You sign in by hand once and the cookies stay there. The agent opens that same browser afterwards and starts where you left off.
A new identity with its own persistent Chrome profile.
The profile holds live cookies. Treat its folder as credentials.
Identities and settingsno identity yet
a browser that cleans up
An agent that browses for an hour leaves dozens of pages behind. turno-browser caps them, parks the ones nobody uses and closes Chrome when no agent is calling it. The next call opens it again with the same profile.
The agent opens a ninth page. The least recently used one closes, never its current tab.
By default: 8 pages, parked after 5 minutes, closed after 15.
Tabs and lifecycleeight pages open
passwords stay out of the model
An identity can keep a username, a password and a one-time code secret per site in your system keychain. The agent asks to sign in by the site's name. The tool fills the form, only on that site's own addresses, and hides the values from every later result.
The password and the one-time secret are asked with hidden prompts.
It does not submit the form unless you turn that on for the identity.
Credential vaultnothing stored yet
on from the start
browser_batch runs up to 20 actions in one call, stops at the first one that fails and returns one line per action.
tool browser_batch
ActionsA click that fails says which element covers the target, or that the target is hidden or disabled, and what to try next.
tool browser_click
ActionsAn agent saves what it did on a site as a flow and runs it again later without working the page out.
Cookies, localStorage and IndexedDB in one file, encrypted with a passphrase you type. It expires, and it never holds vault credentials.
turno-browser do runs one tool call from your terminal: open a page, read its tree, click a ref.
doctor checks Chrome and every identity, with a fix for each problem. The log counts the captchas and "verify it's you" pages each identity met, per site.
opt in
Each of these is a setting of an identity. Nothing below runs until you turn it on, and each one turns off the same way.
A live view of the agent's tab in your own browser. Pause, and your clicks and keys go to that tab. Resume, and the agent is told what changed.
Several agent sessions use one identity's Chrome at once. Each works in its own tabs, never in a tab another session holds.
browser_act carries out a short instruction on the current tab, browser_extract reads data off the page as JSON, and browser_observe proposes the calls without running them. The model is yours to pick.
browser_solve_captcha finds a reCAPTCHA v2, hCaptcha or Turnstile widget, sends its public site key and the page address to a solver service you configure, and puts the token back in the page.
The pointer travels a curve to a point inside the target, the button stays down for a moment and text is typed key by key. Three levels: light, full and adaptive.
Runs the identity on Lightpanda, a headless browser that builds the page without laying it out or drawing it: for reading pages fast and with little memory.
Connects to the Chrome you already have open instead of launching one, so the agent works in your real, signed-in browser. Chrome asks you to allow each connection.
Runs an identity on Camoufox, a Firefox build that sets what the browser reports inside the browser itself, on its own profile. You install it and keep it up to date.
Every session's actions saved as a flow, a Playwright trace with DOM snapshots, network and a screencast, and a screenshot after each action.
Sends an identity through an HTTP or SOCKS proxy, with its password in the system keychain, and builds the user agent from the Chrome you have installed, never from a typed string.
Blocks the trackers, images, media or fonts you name, and keeps images, fonts, stylesheets and scripts on disk for that identity only.
where it sits
A driver moves the browser. turno-browser decides which browser that is, whose session it carries, how long it stays open and what the model gets to see. It works next to browser-use, Stagehand and Browserbase, with Playwright underneath.
How it comparestwo ways in
turno-browser is its own package. Install it, add an identity and point your agent at it.
The package and its command.
Your first identity.
Prints the one command that gives Claude Code the identity. It does the same for Codex, Cursor, Copilot and Gemini.
turno's gateway runs one browser server for every session of every agent, and stops it when nobody uses it.
Both packages.
The identity and its entry in the gateway.
acceptable use
Use it with your own accounts, on sites whose terms allow automated access by you, and at a human pace. Do not use it to get around access controls, paywalls or rate limits, to scrape at scale, or to access accounts that are not yours.
Read the full notestart
Install it, add an identity and sign in once. The docs take it from there.