Skip to content

WEZTERM_* env variables

Category: device · Baseline: rich

$WEZTERM_PANE, $WEZTERM_EXECUTABLE
WezTerm sets a family of WEZTERM_* environment variables in every spawned shell. WEZTERM_PANE contains the numeric pane ID, WEZTERM_EXECUTABLE points at the wezterm binary, and additional variables expose the config directory and unix socket used by the wezterm cli tool. Applications can detect a WezTerm session by checking for these variables, and the wezterm CLI uses them to target the correct pane when invoked from within the terminal.
How this is testedmanual
Manual verification required — no automated probe available.

The same probe runs against headless backends (via Termless) and real terminal apps (via a daemon launched in each terminal). This lets us distinguish parser correctness from rendering correctness.

Supported by 0 of 14 backends (0%)

Terminal Applications

TerminalVersionSupportNotes
iTerm23.6.9? unknown
Ghostty1.3.1? unknown
Terminal.app2.15? unknown
Kitty0.46.2? unknown
VS Code1.113.0? unknown
Warp0.2026.03.18.08.24.03? unknown
Cursor2.6.21? unknown

Headless Backends

Parser correctness only — a means the parser accepts the sequence.

BackendVersionSupportNotes
Alacritty0.26.0? unknown
vt100.js0.2.1? unknown
vterm0.2.0? unknown
WezTerm0.1.0-fork.5? unknown
xterm.js5.5.0? unknown