Environment variables

OpenTUI reads environment variables at runtime. Bun loads .env automatically, so you can set these in your shell or in a .env file.

Variables

Variable	Type	Default	Description
`OTUI_TS_STYLE_WARN`	`string`	`false`	Enable warnings for missing syntax styles
`OTUI_TREE_SITTER_WORKER_PATH`	`string`	`""`	Path to the Tree-sitter worker
`XDG_CONFIG_HOME`	`string`	`""`	Base directory for user-specific configuration files
`XDG_DATA_HOME`	`string`	`""`	Base directory for user-specific data files
`OTUI_DEBUG_FFI`	`boolean`	`false`	Enable debug logging for the FFI bindings
`OTUI_SHOW_STATS`	`boolean`	`false`	Show the debug overlay at startup
`OTUI_TRACE_FFI`	`boolean`	`false`	Enable tracing for the FFI bindings
`OPENTUI_FORCE_WCWIDTH`	`boolean`	`false`	Use wcwidth for character width calculations
`OPENTUI_FORCE_UNICODE`	`boolean`	`false`	Force Mode 2026 Unicode support in terminal capabilities
`OPENTUI_GRAPHICS`	`boolean`	`true`	Enable Kitty graphics protocol detection
`OPENTUI_FORCE_NOZWJ`	`boolean`	`false`	Use no_zwj width method (Unicode without ZWJ joining)
`OPENTUI_FORCE_EXPLICIT_WIDTH`	`string`	-	Force explicit width detection (`true`/`1` or `false`/`0`)
`OTUI_USE_CONSOLE`	`boolean`	`true`	Enable or disable the built-in console capture
`SHOW_CONSOLE`	`boolean`	`false`	Show the console overlay at startup
`OTUI_DUMP_CAPTURES`	`boolean`	`false`	Dump captured output when the renderer exits
`OTUI_NO_NATIVE_RENDER`	`boolean`	`false`	Disable native rendering (debug only)
`OTUI_USE_ALTERNATE_SCREEN`	`boolean`	`true`	Use the terminal alternate screen buffer
`OTUI_OVERRIDE_STDOUT`	`boolean`	`true`	Override the stdout stream (debug only)
`OTUI_DEBUG`	`boolean`	`false`	Enable debug mode to capture raw input