Color Themes¶

Hubuum CLI colors are role based. A theme maps roles such as heading, command, prompt, and table_band to terminal colors.

Bundled public palettes are limited to MIT licensed, or clearly MIT-compatible, sources. The current bundled external palettes are:

Catppuccin Mocha and Latte, from Catppuccin under the MIT license.
Solarized Dark and Light, from Solarized under the MIT license.

First-party themes are distributed under this project's MIT license.

Bundled Themes¶

Themes intended for dark terminal backgrounds:

Name	Character
`hubuum-dark`	Restrained ANSI defaults
`catppuccin-mocha`	Soft pastels
`solarized-dark`	Classic low-contrast Solarized
`aurora-night`	Icy blue, teal, and aurora green
`synthwave-sunset`	Neon cyan, magenta, and violet
`ember-forge`	Copper, amber, and cooling teal
`phosphor-green`	Green-screen terminal glow
`signal-high-contrast`	Bright, highly separated status colors
`rose-pink`	Layered rose and hot-pink tones
`ocean-blue`	Deep navy through bright sky blue
`royal-purple`	Aubergine, violet, and pale lavender
`emerald-green`	Forest shadows and vivid emerald
`lagoon-cyan`	Deep teal through luminous cyan

Themes intended for light terminal backgrounds:

Name	Character
`hubuum-light`	Restrained light defaults
`catppuccin-latte`	Soft light pastels
`solarized-light`	Classic Solarized light
`arctic-day`	Crisp blue and teal
`inkstone-light`	Neutral editorial ink tones

The single-color families keep errors red and warnings yellow. Their remaining roles progress from dark table bands through muted mid-tones to saturated commands and lighter bold headings, so the chosen color remains recognizable without obscuring semantic status.

Selecting Themes¶

List available themes:

hubuum-cli theme list

Preview a theme without changing config:

hubuum-cli theme preview catppuccin-mocha

The preview includes a dense table with alternating row bands. The selected theme's table_band role controls the shaded rows, independently of the active theme and the configured table style. Normal command output applies that role only to dense tables when output.table_bands is auto or always.

Persist a theme and reload the current REPL session:

theme use solarized-dark

You can also select themes with config, environment, or startup flags:

hubuum-cli --theme hubuum-dark
HUBUUM_CLI__OUTPUT__THEME=catppuccin-mocha hubuum-cli
config set --key output.theme --value solarized-dark

--color never still disables all ANSI styling regardless of the selected theme.

File redirects use the same color mode. auto treats files as non-terminals and strips ANSI styling, never also strips it, and always preserves styling codes in the file.

Custom Theme Files¶

Set output.theme_file or pass --theme-file to load additional local themes. Custom theme files are TOML and may inherit from a built-in or another custom theme.

[[theme]]
name = "night-ops"
display_name = "Night Ops"
inherits = "hubuum-dark"

[theme.roles]
command = { fg = "#7ee787" }
heading = { fg = "ansi:cyan", bold = true }
table_band = { bg = "ansi256:235" }

Valid color forms are:

#rrggbb
ansi:<name>, such as ansi:green or ansi:bright-cyan
ansi256:<0-255>

Custom theme names must use lowercase letters, numbers, and dashes.