Skip to Content

ReferenceCommandsMaintenance

turno config

Read and change config.toml without losing its comments; check every config file.

View source
turno config --help
Usage:
  turno config path [--all] [--json]    where each config and state file lives
                                        (--all: every path turno uses)
  turno config get [key] [--json]       print a value (the whole file as JSON
                                        without a key)
  turno config set <key> <value> [--dry-run]
                                        set a value, checked like profile add
                                        checks it
  turno config unset <key> [--dry-run]  remove a value
  turno config edit                     open config.toml in $VISUAL or $EDITOR,
                                        then check it
  turno config check                    parse config.toml, mcp.toml and
                                        accounts.toml

Keys:
  system                    profile the plain claude command (~/.claude) is
                            logged into; "" for none (then turno auto needs a
                            rule)
  default                   Claude Code profile for folders without a rule
  fallback                  Claude Code profile used while the assigned one is
                            exhausted (opt-in)
  agents.<agent>.default    the same for codex, copilot or cursor
  agents.<agent>.fallback   the same for codex, copilot or cursor (opt-in)
  icons                     auto, nerd or unicode
  nerd_terminals            terminals whose font draws Nerd icons
  update_check              true or false: look for new turno releases once a
                            day
  hints                     true or false: print the next step after a command
                            that writes
  open.chrome_dir           folder of the isolated Chrome profiles
  mcpd.port                 port of the MCP gateway
  mcpd.call_log             true or false: keep the log of tool calls (turno mcp
                            log)
  mcpd.max_request_body     largest request mcpd accepts, like "64MiB" (default
                            32MiB)
  mcpd.idle_under_pressure  idle limit of MCP servers while memory is low, like
                            "5m" (default), or false
  profiles.<name>.color     status line pill color
  profiles.<name>.browser   chrome or default

Projects use turno profile assign; MCP servers live in mcp.toml (turno mcp).
A [[projects]] rule with mcp = [...] limits the servers of that folder.

Examples:
  $ turno config path --json
  $ turno config path --all
  $ turno config get default
  $ turno config get mcpd --json
  $ turno config set default work
  $ turno config set icons unicode --dry-run
  $ turno config unset fallback
  $ turno config edit
  $ turno config check

Subcommands

turno config path

Usage:
  turno config path [--all] [--json]  where each config and state file lives
                                      (--all: every path turno uses)

--all adds the logs, tokens, caches, service file, launchers, each agent's
folder and each profile's folder and launcher, with what turno keeps there.
The paths only, never what is in them.

Examples:
  $ turno config path --json
  $ turno config path --all

turno config get

Usage:
  turno config get [key] [--json]  print a value (the whole file as JSON without
                                   a key)

Examples:
  $ turno config get default
  $ turno config get mcpd --json

turno config set

Usage:
  turno config set <key> <value> [--dry-run]
    set a value, checked like profile add checks it

Examples:
  $ turno config set default work
  $ turno config set icons unicode --dry-run

turno config unset

Usage:
  turno config unset <key> [--dry-run]  remove a value

Examples:
  $ turno config unset fallback

turno config edit

Usage:
  turno config edit  open config.toml in $VISUAL or $EDITOR, then check it

Examples:
  $ turno config edit

turno config check

Usage:
  turno config check  parse config.toml, mcp.toml and accounts.toml

Examples:
  $ turno config check

On this page