Skip to Content

ReferenceCommandsDeveloper tools

turno browser

Developer tool: compare browser engines (needs turno-browser)

View source
turno browser --help
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 --yes

Subcommands

turno browser identities

Usage:
  turno browser identities [--json]  list browser identities and whether they
                                     are in use

Examples:
  $ turno browser identities

turno 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,en

turno browser show

Usage:
  turno browser show <id> [--json]  an identity's settings, session health and
                                    who holds it

Examples:
  $ turno browser show school

turno 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 --json

turno 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 --fix

turno 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 --json

turno 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-run

turno 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 2d

turno 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-laptop

turno browser remove

Usage:
  turno browser remove <id> [--dry-run]
    delete an identity, its saved logins and its vault

Examples:
  $ turno browser remove school --dry-run

turno 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.com

turno 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

On this page