Skip to Content

turno-browser

turno-browser

A browser your agents use with your accounts. It stays light on your machine, and the model never sees your passwords.

View source

turno-browser is an MCP server that lets a coding agent drive the Google Chrome installed on your machine, with one persistent profile per identity. You sign in to a site once, by hand, and the agent works in that same signed-in browser afterwards.

It is its own package and works without turno. With turno, the gateway runs one browser server for every session of every agent.

npm install --global turno-browser
turno-browser add school      # a new identity, and how to connect an agent to it
turno-browser login school    # sign in by hand once; cookies persist

Get started goes through those steps and gives the identity to your agent.

What it does

The problemWhat turno-browser doesRead
Your agent opens a browser that is not signed ineach identity is a real Chrome profile that keeps its cookiesIdentities and settings
A browser left open eats the machinepages are capped, parked and closed, and Chrome closes when no agent calls itTabs and lifecycle
Passwords should not pass through a modela vault in the system keychain fills a sign-in form, and the agent never sees the valuesVault, sign-in and secrets

On from the start

Actions and the shellbrowser_batch, errors that say what is in the way, and turno-browser do from a terminal
Flowsan agent saves what it did on a site and runs it again
Moving a sessiona signed-in session in one encrypted file, for another machine
Session health, reputation and doctora signed-out identity says so, and each site's challenges are counted

Off until you turn it on

Each of these is a setting of an identity. Whether to turn one on is your call; each page says what it does and what it costs.

Several agents, one browserseveral sessions in one identity's Chrome, each in its own tabs
Live view and take-overwatch the agent's tab, pause it and act yourself
Recordings and tracesevery session as a flow, a trace and screenshots
Human-like inputthe pointer moves along a curve and text is typed key by key
Blocking and the resource cacheblock trackers and resource types, and cache static files on disk
A coherent user agent and a proxyhow an identity's browser reaches sites
Enginesread mode on Lightpanda, attach to your own Chrome, or Camoufox
Natural language actionsbrowser_act, browser_extract and browser_observe, on a model you pick
Captcha solvingbrowser_solve_captcha, through a solver service you configure

Reference and help

On this page