skit

Environment variables

Every variable skit reads, and the ones it sets for child processes.

Variables skit reads

VariableEffect
SKIT_DATA_DIRoverrides the data root — the library, stored copies, drafts, and skit's private uv
SKIT_STATE_DIRoverrides the state root — last-used values, presets, run history
SKIT_CONFIG_DIRoverrides the config root — config.toml
SKIT_LANGUI language for this process (SKIT_LANG=zh-TW skit)
VISUAL / EDITOReditor, when the editor config key is unset
TERMTERM=dumb switches interactive flows to plain line prompts (screen readers, Emacs shells). In the skit theme, a 256color or kitty suffix gives 256 colors, and any other value gives 16
COLORTERMtruecolor or 24bit lets the skit theme use 24-bit color. On Windows, the skit theme always uses 24-bit color
NO_COLORremoves every color and keeps bold, dim, and reverse video. The interface obeys it when it is set, also when it is empty; line output obeys it only when it is not empty
SSH_CONNECTION / SSH_TTYskit does not ask the terminal for its background, so the terminal theme uses no accent hue
WT_SESSION (Windows)Windows Terminal sets it. On Windows, skit asks the terminal for its background only when it is set
PATHEXT (Windows)decides which extensions count as runnable when classifying executables

Precedence details:

  • Language: SKIT_LANG → the lang config key → LC_ALL → LC_MESSAGES → LANG → system locale. A value of C is ignored.
  • Editor: the editor config key → VISUAL → EDITOR → platform default (notepad on Windows, vi elsewhere). Blank values count as unset.

skit doctor prints the resolved data/state/config paths.

Variables skit sets for the processes it launches

Mirror settings apply as an environment overlay on skit's own child processes — never written to your shell, PATH, or global uv config — and each defers to a value you already set yourself:

VariableFed byDefers to
UV_DEFAULT_INDEXmirror.pypiyour own UV_DEFAULT_INDEX or UV_INDEX_URL
UV_PYTHON_INSTALL_MIRRORmirror.github—
NPM_CONFIG_REGISTRYmirror.npmyour own NPM_CONFIG_REGISTRY / npm_config_registry (note: npm ranks this variable above ~/.npmrc)

The uppercase NPM_CONFIG_REGISTRY form reaches npm, bun, and deno alike. Parameter values delivered via environment are overlaid last, so an explicitly set parameter beats both the ambient environment and skit's mirror variables.

On this page