# turno identity (/docs/reference/cli/identity)

Who acts on outside services: service accounts (linear:work) and browser identities (browser:school)

```text title="turno identity --help"
Usage:
  turno identity list [--json]  service accounts, browser identities and folder
                                preferences
  turno identity add <service:label> --profile <p> --tools <pattern>[,...]
      [--read-tools <pattern>[,...]] [--confirm always|writes|never] |
      browser:<id> [--timezone <zone>] [--languages <tag,...>] [--health-url
      <url> --health-text <text>] [--dry-run]
                                add a service account, or create a browser
                                identity (browser:<id>)
  turno identity show browser:<id> [--json]
                                a browser identity's settings, session health
                                and who holds it
  turno identity set browser:<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 a browser identity's identity.json:
                                place, languages, health check, tabs, blocking,
                                cache
  turno identity remove <id> [--dry-run]
                                remove a service account, or delete a browser
                                identity and its logins
  turno identity login browser:<id> [--url <url>]
                                open a browser identity's Chrome to sign in by
                                hand once
  turno identity prefer <dir> <service>=<account> [--dry-run]
                                pick the account of a service for a folder
                                (empty account removes it)
  turno identity log [-n N] [--verify] [--json]
                                recent calls to the accounts bridge; --verify
                                checks the log's hash chain

Examples:
  $ turno identity list
  $ turno identity add linear:work --profile work --tools 'mcp__linear__*'
  $ turno identity add browser:school
  $ turno identity login browser:school
  $ turno identity show browser:school
  $ turno identity set browser:school --timezone Europe/Madrid --languages es-ES,es,en
  $ turno identity set browser:school --tabs-max 5 --tabs-park 10m --background-throttling true
  $ turno identity set browser:school --block-trackers true --block-types image,font --cache-max-size 200MB
  $ turno identity set browser:school --settle 500ms --dry-run --json
  $ turno identity set browser:school --no-block --no-cache
  $ turno identity prefer ~/code/acme linear=linear:work
  $ turno identity remove linear:work --dry-run
  $ turno identity log --verify
```

## Subcommands [#subcommands]

### turno identity list [#turno-identity-list]

```text
Usage:
  turno identity list [--json]  service accounts, browser identities and folder
                                preferences

Examples:
  $ turno identity list
```

### turno identity add [#turno-identity-add]

```text
Usage:
  turno identity add <service:label> --profile <p> --tools <pattern>[,...]
      [--read-tools <pattern>[,...]] [--confirm always|writes|never] |
      browser:<id> [--timezone <zone>] [--languages <tag,...>] [--health-url
      <url> --health-text <text>] [--dry-run]
    add a service account, or create a browser identity (browser:<id>)

Examples:
  $ turno identity add linear:work --profile work --tools 'mcp__linear__*'
  $ turno identity add browser:school
```

### turno identity show [#turno-identity-show]

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

Examples:
  $ turno identity show browser:school
```

### turno identity set [#turno-identity-set]

```text
Usage:
  turno identity set browser:<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 a browser identity's identity.json: place, languages, health check,
    tabs, blocking, cache

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 identity set browser:school --timezone Europe/Madrid --languages es-ES,es,en
  $ turno identity set browser:school --tabs-max 5 --tabs-park 10m --background-throttling true
  $ turno identity set browser:school --block-trackers true --block-types image,font --cache-max-size 200MB
  $ turno identity set browser:school --settle 500ms --dry-run --json
  $ turno identity set browser:school --no-block --no-cache
```

### turno identity remove [#turno-identity-remove]

```text
Usage:
  turno identity remove <id> [--dry-run]
    remove a service account, or delete a browser identity and its logins

Examples:
  $ turno identity remove linear:work --dry-run
```

### turno identity login [#turno-identity-login]

```text
Usage:
  turno identity login browser:<id> [--url <url>]
    open a browser identity's Chrome to sign in by hand once

Examples:
  $ turno identity login browser:school
```

### turno identity prefer [#turno-identity-prefer]

```text
Usage:
  turno identity prefer <dir> <service>=<account> [--dry-run]
    pick the account of a service for a folder (empty account removes it)

Examples:
  $ turno identity prefer ~/code/acme linear=linear:work
```

### turno identity log [#turno-identity-log]

```text
Usage:
  turno identity log [-n N] [--verify] [--json]
    recent calls to the accounts bridge; --verify checks the log's hash chain

Examples:
  $ turno identity log --verify
```