Skip to Content

Reference

Environment variables

Every environment variable turno reads, and the ones it sets for the agents it starts.

View source

This page lists every environment variable turno reads. turno help environment prints the same list.

Where turno keeps things

VariableWhat it does
TURNO_CONFIG_DIRconfig.toml and mcp.toml (default: $XDG_CONFIG_HOME/turno, else ~/.config/turno)
TURNO_STATE_DIRstate, logs, caches and backups (default: $XDG_STATE_HOME/turno, else ~/.local/state/turno)
TURNO_DATA_DIRinstalled servers and browser identities (default: $XDG_DATA_HOME/turno, else ~/.local/share/turno)
TURNO_BINwhere the launchers go (default: ~/.local/bin)
TURNO_HUBClaude Code's shared folder (default: ~/.claude)
TURNO_HUB_CONFIGClaude Code's shared .claude.json (default: ~/.claude.json)
TURNO_FONT_DIRwhere turno ui installs the status line font
TURNO_APPS_DIRwhere turno looks for terminal apps on macOS (default: /Applications)
TURNO_CHROME_APPGoogle Chrome on macOS, for turno open (default: /Applications/Google Chrome.app)
TURNO_CHROME_BINthe Chrome program on Linux, for turno open

How turno behaves

VariableWhat it does
TURNO_NO_INPUT1: never ask, exit 2 and name the flag instead (same as --no-input); 0: ask even inside an agent session
TURNO_COLORalways, never or auto (same as --color); see the order below
TURNO_ALLOW_PLAIN1: turno auto runs the plain agent when config.toml does not parse
TURNO_SAFE1: turno run, turno <profile> and turno auto open the agent in safe mode, without the gateway and the status line (same as --no-gateway)
TURNO_NO_UPDATE_CHECK1: no daily update check and no notice
TURNO_NO_UPDATE_NOTIFIER1: same as TURNO_NO_UPDATE_CHECK (the name gh uses)
TURNO_REGISTRYnpm registry for update checks (default: npm_config_registry, else registry.npmjs.org)
TURNO_BROWSER_IDLEturno-browser closes Chrome after this long without a tool call (default: 15m)

Set by turno for the agents it starts (read them, do not set them)

VariableWhat it does
TURNO_PROFILEthe profile a launcher opened
TURNO_AGENTthat profile's agent (codex, copilot, cursor)
TURNO_SESSION_PIDthe agent's process id, sent to the gateway
TURNO_SESSION_CWD_B64the agent's folder (base64url), sent to the gateway
TURNO_MCPD_TOKENthe profile's gateway token, for agents that read headers from the environment
TURNO_MCPD_SERVICEset by the mcpd service file (LaunchAgent or systemd unit)

Standard variables turno honors

VariableWhat it does
NO_COLORset and not empty: no colors (no-color.org)
FORCE_COLOR0 or false: no colors; anything else: colors, also in a pipe
CLICOLOR_FORCEset and not 0: colors, also in a pipe
CLICOLOR0: no colors
TERMdumb: no colors
COLUMNSthe width to lay out for (default: the terminal's, else 80)
DO_NOT_TRACK1: no update check (turno sends nothing else anywhere)
CIset: no update check
NO_UPDATE_NOTIFIER1: no update check
XDG_CONFIG_HOME, XDG_STATE_HOME, XDG_DATA_HOME, XDG_CACHE_HOMEbase folders, when the TURNO_* ones are not set
VISUAL, EDITORthe editor of turno config edit
NODE_COMPILE_CACHE, NODE_DISABLE_COMPILE_CACHENode's compile cache (turno keeps it in $XDG_CACHE_HOME/turno)

What turno help environment prints

Environment variables turno reads.

Where turno keeps things:
  TURNO_CONFIG_DIR  config.toml and mcp.toml (default: $XDG_CONFIG_HOME/turno,
                    else ~/.config/turno)
  TURNO_STATE_DIR   state, logs, caches and backups (default:
                    $XDG_STATE_HOME/turno, else ~/.local/state/turno)
  TURNO_DATA_DIR    installed servers and browser identities (default:
                    $XDG_DATA_HOME/turno, else ~/.local/share/turno)
  TURNO_BIN         where the launchers go (default: ~/.local/bin)
  TURNO_HUB         Claude Code's shared folder (default: ~/.claude)
  TURNO_HUB_CONFIG  Claude Code's shared .claude.json (default: ~/.claude.json)
  TURNO_FONT_DIR    where turno ui installs the status line font
  TURNO_APPS_DIR    where turno looks for terminal apps on macOS (default:
                    /Applications)
  TURNO_CHROME_APP  Google Chrome on macOS, for turno open (default:
                    /Applications/Google Chrome.app)
  TURNO_CHROME_BIN  the Chrome program on Linux, for turno open

How turno behaves:
  TURNO_NO_INPUT            1: never ask, exit 2 and name the flag instead (same
                            as --no-input); 0: ask even inside an agent session
  TURNO_COLOR               always, never or auto (same as --color); see the
                            order below
  TURNO_ALLOW_PLAIN         1: turno auto runs the plain agent when config.toml
                            does not parse
  TURNO_SAFE                1: turno run, turno <profile> and turno auto open
                            the agent in safe mode, without the gateway and the
                            status line (same as --no-gateway)
  TURNO_NO_UPDATE_CHECK     1: no daily update check and no notice
  TURNO_NO_UPDATE_NOTIFIER  1: same as TURNO_NO_UPDATE_CHECK (the name gh uses)
  TURNO_REGISTRY            npm registry for update checks (default:
                            npm_config_registry, else registry.npmjs.org)
  TURNO_BROWSER_IDLE        turno-browser closes Chrome after this long without
                            a tool call (default: 15m)

Set by turno for the agents it starts (read them, do not set them):
  TURNO_PROFILE          the profile a launcher opened
  TURNO_AGENT            that profile's agent (codex, copilot, cursor)
  TURNO_SESSION_PID      the agent's process id, sent to the gateway
  TURNO_SESSION_CWD_B64  the agent's folder (base64url), sent to the gateway
  TURNO_MCPD_TOKEN       the profile's gateway token, for agents that read
                         headers from the environment
  TURNO_MCPD_SERVICE     set by the mcpd service file (LaunchAgent or systemd
                         unit)

Standard variables turno honors:
  NO_COLOR            set and not empty: no colors (no-color.org)
  FORCE_COLOR         0 or false: no colors; anything else: colors, also in a
                      pipe
  CLICOLOR_FORCE      set and not 0: colors, also in a pipe
  CLICOLOR            0: no colors
  TERM                dumb: no colors
  COLUMNS             the width to lay out for (default: the terminal's, else
                      80)
  DO_NOT_TRACK        1: no update check (turno sends nothing else anywhere)
  CI                  set: no update check
  NO_UPDATE_NOTIFIER  1: no update check
  XDG_CONFIG_HOME, XDG_STATE_HOME, XDG_DATA_HOME, XDG_CACHE_HOME
                      base folders, when the TURNO_* ones are not set
  VISUAL, EDITOR      the editor of turno config edit
  NODE_COMPILE_CACHE, NODE_DISABLE_COMPILE_CACHE
                      Node's compile cache (turno keeps it in
                      $XDG_CACHE_HOME/turno)

Colors: the first that applies wins: --color, TURNO_COLOR, NO_COLOR, FORCE_COLOR,
CLICOLOR_FORCE, then CLICOLOR=0 or TERM=dumb, then whether output is a terminal.
--json output is colored only on a terminal.

Examples:
  $ NO_COLOR=1 turno status
  $ TURNO_NO_INPUT=1 turno profile remove work  # fails fast instead of asking
  $ TURNO_CONFIG_DIR=/tmp/t turno doctor
  $ TURNO_SAFE=1 turno work  # without the gateway, to tell whether a problem is turno's

On this page