turno-browser · Open source · Apache-2.0 · macOS and Linux

A browser your agents use with your accounts.

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.

Read the docs
  • On your machineNo cloud browser and no bill per hour.
  • The Chrome you haveIt drives the Google Chrome on your machine and downloads no browser.
  • No account, no API keyInstall it and it works.
  • Free and open sourceApache-2.0.

one profile per identity

Signed in before the agent arrives.

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.

  1. A new identity with its own persistent Chrome profile.

The profile holds live cookies. Treat its folder as credentials.

Identities and settings
youagent
no identity yet

no identity yet

a browser that cleans up

Left open for hours, it stays light.

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.

  1. 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 lifecycle
running 8parked 015 min later
maildocsapirepowikicalformsnewsat most 8
campus.example.edu/newsschool

eight pages open

passwords stay out of the model

The model never sees your passwords.

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.

  1. 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 vault
system keychain
nothing yetusernamemepassword••••••••one-time code••••••
campus.example.edu/loginschool
usernamepasswordone-time codeSign in
what the model seesThe model is not part of this step.

nothing stored yet

on from the start

Already working when you install it.

Many actions, one call

on

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

Actions

Errors that name what is in the way

on

A 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

Actions

Record once, replay later

on

An agent saves what it did on a site as a flow and runs it again later without working the page out.

Flows

Take a signed-in session to another machine

on

Cookies, localStorage and IndexedDB in one file, encrypted with a passphrase you type. It expires, and it never holds vault credentials.

Moving a session

Drive it from a shell

on

turno-browser do runs one tool call from your terminal: open a page, read its tree, click a ref.

From the shell

A doctor and a reputation log

on

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.

Doctor

opt in

Off by default. On when you say so.

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.

Watch it work, and take the controls

opt in

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.

Live view

Several agents, one browser

opt in

Several agent sessions use one identity's Chrome at once. Each works in its own tabs, never in a tab another session holds.

Sharing a browser

Actions in plain words

opt in

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.

Natural language actions

Captcha solving

opt in

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.

Captcha solving

Human-like input

opt in

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.

Human-like input

Read mode

opt in

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.

Read mode

Attach to your own Chrome

opt in

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.

Attach

Camoufox

opt in

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.

Camoufox

Recordings and traces

opt in

Every session's actions saved as a flow, a Playwright trace with DOM snapshots, network and a screencast, and a screenshot after each action.

Recordings and traces

A proxy and a coherent user agent

opt in

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.

Network and user agent

Lighter pages

opt in

Blocks the trackers, images, media or fonts you name, and keeps images, fonts, stylesheets and scripts on disk for that identity only.

Blocking and the cache

where it sits

The layer above the driver.

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 compares

two ways in

On its own, or with turno.

On its own

turno-browser is its own package. Install it, add an identity and point your agent at it.

  1. The package and its command.

  2. Your first identity.

  3. Prints the one command that gives Claude Code the identity. It does the same for Codex, Cursor, Copilot and Gemini.

With turno

turno's gateway runs one browser server for every session of every agent, and stops it when nobody uses it.

  1. Both packages.

  2. The identity and its entry in the gateway.

What turno does

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 note

start

Set it up in one command.

Install it, add an identity and sign in once. The docs take it from there.

Read the docs See turno

turno is an independent open-source project. It is not affiliated with, endorsed by or sponsored by any vendor of the tools it works with.

Made by wimodev