Skip to Content

Reference

config.toml

Every key of ~/.config/turno/config.toml: profiles, folder rules and gateway settings.

View source

This page lists every key ~/.config/turno/config.toml may hold. turno warns about a key it does not know and ignores it.

turno config set <key> <value> changes a value without losing the file's comments, turno config check parses every config file, and turno config path says where each one lives.

Keys you set with turno config

KeyWhat it does
systemprofile the plain claude command (~/.claude) is logged into; "" for none (then turno auto needs a rule)
defaultClaude Code profile for folders without a rule
fallbackClaude Code profile used while the assigned one is exhausted (opt-in)
agents.<agent>.defaultthe same for codex, copilot or cursor
agents.<agent>.fallbackthe same for codex, copilot or cursor (opt-in)
iconsauto, nerd or unicode
nerd_terminalsterminals whose font draws Nerd icons
update_checktrue or false: look for new turno releases once a day
hintstrue or false: print the next step after a command that writes
open.chrome_dirfolder of the isolated Chrome profiles
mcpd.portport of the MCP gateway
mcpd.call_logtrue or false: keep the log of tool calls (turno mcp log)
mcpd.max_request_bodylargest request mcpd accepts, like "64MiB" (default 32MiB)
mcpd.idle_under_pressureidle limit of MCP servers while memory is low, like "5m" (default), or false
profiles.<name>.colorstatus line pill color
profiles.<name>.browserchrome or default

Keys turno writes for you

Profiles and folder rules have their own commands (turno profile add, turno profile assign), and a rule's server set is edited in the file.

KeyWhat it does
profiles.<name>.agentthe agent of a profile that is not Claude Code: codex, copilot or cursor (set by turno profile add --agent)
projects[].paththe folder a rule applies to, and everything under it
projects[].profilethe profile sessions in that folder use (set by turno profile assign)
projects[].mcpkeep only these MCP servers for sessions in that folder, by their name in mcp.toml
projects[].mcp_denyhide these MCP servers from sessions in that folder

An example

~/.config/turno/config.toml
system = "personal"     # account the plain `claude` command uses ("" for none)
default = "personal"    # profile for folders without a rule

[profiles.work]
color = "violet"        # status line pill
[profiles.cx]
agent = "codex"

[[projects]]
path = "~/code/acme"
profile = "work"

[[projects]]
path = "~/code/oss"
mcp_deny = ["mail"]     # sessions here see every MCP server but mail

[mcpd]
port = 47821

What turno config --help prints

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

On this page