Environment variables
Every environment variable turno reads, and the ones it sets for the agents it starts.
This page lists every environment variable turno reads. turno help environment prints the same list.
Where turno keeps things
| Variable | What it does |
|---|---|
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
| Variable | What it does |
|---|---|
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)
| Variable | What it does |
|---|---|
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
| Variable | What it does |
|---|---|
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) |
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