ReferenceCommandsDeveloper tools
turno browser
Developer tool: compare browser engines (needs turno-browser)
Usage:
turno browser identities [--json] list browser identities and whether they
are in use
turno browser add <id> [--timezone <zone>] [--locale <tag>] [--languages
<tag,...>] [--region <CC>] [--health-url <url> --health-text <text>]
[--dry-run]
create an identity (pinned to this time
zone) and print its mcp.toml block
turno browser show <id> [--json] an identity's settings, session health and
who holds it
turno browser set <id> [--timezone <zone>] [--locale <tag>] [--languages
<tag,...>] [--region <CC>] [--health-url <url>] [--health-text <text>]
[--health-selector <css>] [--no-health] [--tabs-max <n>] [--tabs-popups
close|keep] [--tabs-park <duration>] [--tabs-close <duration>] [--no-tabs]
[--background-throttling true|false] [--settle <duration>]
[--block-trackers true|false] [--block-types image,media,font]
[--block-patterns <host|glob>,...] [--no-block] [--cache]
[--cache-max-size <size>] [--no-cache] [--dry-run] [--json]
change an identity's identity.json (an
empty value removes a setting)
turno browser doctor [--fix] [--no-launch] [--json]
check Chrome, a test launch and every
identity (settings, lock, sign-in), with
fixes
turno browser reputation [<id>] [--json]
challenges each identity met per site
(captcha, verify it's you, block) and their
trend
turno browser vault add|list|remove|submit <id> ...
credentials browser_login fills without
showing them to the agent
turno browser export <id> --out <file> [--expires 7d] [--force]
write an identity's cookies and site
storage to a file encrypted with a
passphrase
turno browser import <file> [--as <id>] [--yes] [--dry-run]
replace an identity's session with an
export (asks first), or create it
turno browser remove <id> [--dry-run]
delete an identity, its saved logins and
its vault
turno browser login <id> [--url <url>]
open the identity's Chrome to sign in by
hand once
turno browser bench [--engine <name>]... [--url <url>]... [--only-urls]
[--yes] [--json]
check how each browser engine loads
reference test pages and your URLs (asks
first)
A developer diagnostic for browser engine compatibility. It needs the separate
turno-browser package (npm install --global turno-browser).
Identities are persistent Chrome profiles served by turno-browser-mcp, one session at a time
through mcpd; turno identity manages them too (browser:<id>). Ids use lowercase letters,
digits, "-" and "_", for example "school".
Examples:
$ turno browser identities
$ turno browser add school --languages es-MX,es,en
$ turno browser show school
$ turno browser set school --health-url https://mail.example.com/ --health-text Inbox
$ turno browser set school --tabs-max 5 --tabs-popups keep --settle 250ms
$ turno browser set school --block-trackers true --cache --json
$ turno browser login school --url https://example.com
$ turno browser doctor --fix
$ turno browser reputation school --json
$ turno browser vault add school mail --url https://mail.example.com --username alice
$ turno browser export school --out school.session --expires 2d
$ turno browser import school.session --as school-laptop
$ turno browser remove school --dry-run
$ turno browser bench --only-urls --url https://example.com --yesSubcommands
turno browser identities
Usage:
turno browser identities [--json] list browser identities and whether they
are in use
Examples:
$ turno browser identitiesturno browser add
Usage:
turno browser add <id> [--timezone <zone>] [--locale <tag>] [--languages
<tag,...>] [--region <CC>] [--health-url <url> --health-text <text>]
[--dry-run]
create an identity (pinned to this time zone) and print its mcp.toml block
Examples:
$ turno browser add school --languages es-MX,es,enturno browser show
Usage:
turno browser show <id> [--json] an identity's settings, session health and
who holds it
Examples:
$ turno browser show schoolturno browser set
Usage:
turno browser set <id> [--timezone <zone>] [--locale <tag>] [--languages
<tag,...>] [--region <CC>] [--health-url <url>] [--health-text <text>]
[--health-selector <css>] [--no-health] [--tabs-max <n>] [--tabs-popups
close|keep] [--tabs-park <duration>] [--tabs-close <duration>] [--no-tabs]
[--background-throttling true|false] [--settle <duration>]
[--block-trackers true|false] [--block-types image,media,font]
[--block-patterns <host|glob>,...] [--no-block] [--cache]
[--cache-max-size <size>] [--no-cache] [--dry-run] [--json]
change an identity's identity.json (an empty value removes a setting)
Each flag writes one key of identity.json; an empty value (--settle "") removes it, and
--no-health, --no-tabs, --no-block and --no-cache remove a whole group. A flag of a group
changes only its part: the rest of that group stays.
How the host runs this identity's Chrome (read at every Chrome start):
--tabs-max <n> most tabs open at once, 0 for no cap (default 8)
--tabs-popups close|keep close popups the agent did not open (default close)
--tabs-park <duration> park an unused tab on about:blank, "0" never (default 5m)
--tabs-close <duration> close an unused tab, "0" never (default 15m)
--background-throttling <bool> let Chrome slow tabs that are not in front (default false)
--settle <duration> wait after each action for the work it started, "0" to "10s"
--block-trackers <bool> block a built-in list of ad and analytics hosts
--block-types <list> block image, media and font requests (never the page itself)
--block-patterns <list> block host names (and subdomains) or URL globs with *
--cache keep images, fonts, styles and scripts on disk (100MB)
--cache-max-size <size> the cache's size, "1MB" to "10GB"; turns the cache on
Blocking without the cache turns Chrome's own HTTP cache off: use them together.
Examples:
$ turno browser set school --health-url https://mail.example.com/ --health-text Inbox
$ turno browser set school --tabs-max 5 --tabs-popups keep --settle 250ms
$ turno browser set school --block-trackers true --cache --jsonturno browser doctor
Usage:
turno browser doctor [--fix] [--no-launch] [--json]
check Chrome, a test launch and every identity (settings, lock, sign-in),
with fixes
Examples:
$ turno browser doctor --fixturno browser reputation
Usage:
turno browser reputation [<id>] [--json]
challenges each identity met per site (captcha, verify it's you, block) and
their trend
Examples:
$ turno browser reputation school --jsonturno browser vault
Usage:
turno browser vault add <identity> <site> --url <sign-in page> [--url
<url>]... [--username <name>] [--totp] [--dry-run]
store a site's username, password and optional TOTP secret (asked hidden, or
on stdin)
turno browser vault list <identity> [--json]
the sites in an identity's vault (never the values)
turno browser vault remove <identity> <site> [--dry-run]
delete a site's credentials
turno browser vault submit <identity> <confirm|auto> [--dry-run]
let browser_login submit the form (auto) or leave the click to the agent
(confirm, default)
The vault keeps a username, a password and optionally a TOTP secret per site for one
browser identity, only in the secret store (the macOS Keychain or the Linux Secret Service).
The browser_login tool fills them into the site's sign-in page without the agent seeing them,
and only on the origins given with --url. In a terminal the password and the TOTP secret are
asked with hidden prompts; from a pipe, the first line of stdin is the password and, with
--totp, the second line is the TOTP secret (base32, or the otpauth:// URI of the QR code).
Examples:
$ turno browser vault add work github --url https://github.com/login --username alice --totp
$ printf '%s\n' "$PASSWORD" | turno browser vault add work mail --url https://mail.example.com --username alice@example.com
$ turno browser vault list work
$ turno browser vault list work --json
$ turno browser vault submit work auto
$ turno browser vault remove work github --dry-runturno browser export
Usage:
turno browser export <id> --out <file> [--expires 7d] [--force]
write an identity's cookies and site storage to a file encrypted with a
passphrase
Examples:
$ turno browser export school --out school.session --expires 2dturno browser import
Usage:
turno browser import <file> [--as <id>] [--yes] [--dry-run]
replace an identity's session with an export (asks first), or create it
Examples:
$ turno browser import school.session --as school-laptopturno browser remove
Usage:
turno browser remove <id> [--dry-run]
delete an identity, its saved logins and its vault
Examples:
$ turno browser remove school --dry-runturno browser login
Usage:
turno browser login <id> [--url <url>]
open the identity's Chrome to sign in by hand once
Examples:
$ turno browser login school --url https://example.comturno browser bench
Usage:
turno browser bench [--engine <name>]... [--url <url>]... [--only-urls]
[--yes] [--json]
check how each browser engine loads reference test pages and your URLs (asks
first)
Examples:
$ turno browser bench --only-urls --url https://example.com --yes