# Environment variables (/docs/reference/environment)

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 [#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 [#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 &lt;profile&gt; 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) [#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 [#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 [#what-turno-help-environment-prints]

```text
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
```