Themes

Themes

ssm ships with 7 built-in color themes. Each theme defines four accent roles — header, select, error, and dim — while the terminal's own background shows through.

Available themes

Theme	Key	Description
auto	a	Follows the terminal's ANSI palette (default)
noir-cat	o	Catppuccin Mocha accents on a noir background
knew-pines	k	Rose Pine inspired
catppuccin	c	Catppuccin Mocha
gruvbox	g	Gruvbox
nord	n	Nord
tokyo-night	t	Tokyo Night

Switching themes

From the TUI

Press Space → Settings → t to open the theme picker, then press the theme's mnemonic key to switch live.

From config.toml

Set the theme key in ~/.config/ssm/config.toml:

theme = "gruvbox"

auto theme

The auto theme uses standard ANSI colors (Cyan for headers, Green for selection, Red for errors, DarkGray for dim text), so it inherits whatever palette your terminal defines. This is the default and works well with any terminal color scheme.