Configuration

This chapter is a lookup reference for environment variables that affect richterm behavior directly.

RICHTERM_THEME

Sets the default SVG terminal theme for richterm. Supported values are default, light, monokai, dimmed-monokai, night-owlish, and svg-export. The command-line --theme option and the directive :theme: option take precedence over this environment variable.

RICHTERM_DISABLE_COLOR_HINT

Disables the extra color-friendly environment hints that richterm normally injects before running a command. When set to 1, richterm leaves the child environment unchanged.

NO_COLOR

Standard opt-out flag for colored terminal output. richterm respects this convention through the underlying Rich rendering behavior unless color is explicitly forced. Reference: https://no-color.org/

FORCE_COLOR

Forces color output in environments that would otherwise disable it. richterm uses it as one of the hints for non-interactive command captures.

TERM

Terminal capability identifier passed to the executed command. If it is missing or set to dumb, richterm defaults it to xterm-256color to improve captured styling.