Terminal color schemes in Termhint
Updated 19 November 2026All docs
Termhint can color your terminals with one color scheme: the background, text, cursor, selection
and the 16 colors programs print with. This page lists the schemes, every termhint colors
command, what happens in each terminal, and how to go back to each terminal's own colors. For an
overview, see terminal colors.
How it works
- When zsh or bash starts, it sends its terminal the colors as escape sequences (OSC 4, 10, 11, 12, 17 and 19): the 16 ANSI colors, text, background, cursor and selection. No terminal's settings change, so this works in any terminal that understands these sequences; a terminal ignores the ones it doesn't know.
- Open tabs switch at once when you pick a scheme; new tabs get it when their shell starts. bash picks a change up at its next prompt.
- A new window shows its own colors for the moment before the shell is up, and a window that runs something other than your shell keeps its own colors. Native config removes that moment in Ghostty, kitty, WezTerm and Alacritty.
- Not inside tmux or screen.
- Colors need the shell integration:
termhint installfor zsh (the app adds it at launch), ortermhint install bash. See Install.
Color schemes
23 schemes are built in. Use the id with termhint colors set.
| Scheme | Id | Appearance |
|---|---|---|
| Ayu Mirage | ayu-mirage |
Dark |
| Catppuccin Latte | catppuccin-latte |
Light |
| Catppuccin Mocha | catppuccin-mocha |
Dark |
| Dracula | dracula |
Dark |
| Everforest Dark | everforest-dark |
Dark |
| Everforest Light | everforest-light |
Light |
| GitHub Dark | github-dark |
Dark |
| GitHub Light | github-light |
Light |
| Gruvbox Dark | gruvbox-dark |
Dark |
| Gruvbox Light | gruvbox-light |
Light |
| Kanagawa | kanagawa |
Dark |
| Nord | nord |
Dark |
| Nord Light | nord-light |
Light |
| One Dark | one-dark |
Dark |
| One Half Dark | one-half-dark |
Dark |
| One Half Light | one-half-light |
Light |
| One Light | one-light |
Light |
| Rosé Pine | rose-pine |
Dark |
| Rosé Pine Dawn | rose-pine-dawn |
Light |
| Solarized Dark | solarized-dark |
Dark |
| Solarized Light | solarized-light |
Light |
| Tokyo Night | tokyo-night |
Dark |
| Tokyo Night Day | tokyo-night-day |
Light |
Each scheme's author and license are listed in Termhint's third-party notices. The scheme you
make in Settings is custom, and your own scheme files are listed too.
Choose a scheme
In the app: Settings → Terminal → Colors. The schemes are tiles you can search and filter (dark,
light); Show All unfolds the whole list. Pointing at a tile previews it in the terminal above;
a click uses it. Use in my terminals turns the colors on or off in your terminals. Under
More, Color the command while it is typed and Color file lists are the --syntax and
--lists options below, and Every color edits each color of your own scheme.
From the command line:
termhint colors list # the schemes (* = in use)
termhint colors preview nord # this window only
termhint colors reset # end the preview
termhint colors set tokyo-night # all your terminals: open tabs at once
termhint colors set dracula --light solarized-light # one for dark, one for light
termhint colors native ghostty # also in Ghostty's own config
termhint colors off # each terminal's own colors again
Colors commands
| Command | What it does |
|---|---|
termhint colors list |
Each scheme with its appearance (* = in use), then what is in use: the schemes, file lists, highlighting and the terminals whose own config has the colors |
termhint colors set <scheme> |
Color your terminals with this scheme: an id from colors list, or a path to a .json scheme file. Options you leave out stay as they were |
termhint colors preview <scheme> |
Color this window only, until termhint colors reset or it closes |
termhint colors reset |
End a preview: this window goes back to the scheme in use, or its own colors |
termhint colors native <terminal> |
Also put the colors into a terminal's own config: ghostty, kitty, wezterm, alacritty, or all (those found on this Mac). Needs a scheme in use |
termhint colors native off <terminal> |
Take the colors out of that config again; all means every one |
termhint colors off |
Give each terminal its own colors back |
Options of colors set:
| Option | What it does |
|---|---|
--light <scheme> |
Use this scheme while macOS is light, and the scheme given first while it is dark |
--lists |
Also color file lists (ls, completion lists) where nothing else does |
--no-lists |
Stop coloring file lists |
--syntax |
Also set the colors zsh-syntax-highlighting and zsh-autosuggestions use on the command line |
--no-syntax |
Stop coloring the command line's highlighting |
--lists and --syntax stay on until you turn them off with --no-lists or --no-syntax.
Light and dark
With --light, one scheme is for dark appearance and the other for light:
termhint colors set catppuccin-mocha --light catppuccin-latte
When macOS switches appearance, the Termhint app applies the other scheme and tells the open shells. In their own config (below), Ghostty and WezTerm switch between the two by themselves; kitty and Alacritty get the scheme for the current appearance, and the app rewrites it when macOS switches.
Colors in each terminal
| Terminal | How it gets the colors |
|---|---|
| Ghostty, kitty, WezTerm, Alacritty | From the shell; and, with colors native, from their own config, so their windows open in the colors before a shell starts |
| Terminal | From the shell only: it keeps its settings in a preferences database. It has no separate color for selected text |
| iTerm2 | From the shell only: it keeps its settings in a preferences database |
| Other terminals (VS Code, Cursor, Hyper, Tabby, …) | From the shell |
See Terminals for the supported terminals.
Native config
termhint colors native <terminal> (or the Colors switch per app in Settings → Terminal →
Apps) writes Termhint's own color files and adds one marked block to the terminal's config,
backed up first. termhint colors native off <terminal> gives the config back exactly as it was,
and removes a config file Termhint created. The switches in Settings need Use in my terminals
on.
| Terminal | Config file: the first of these that exists | Created when none exists | Termhint's color files | After a change |
|---|---|---|---|---|
| Ghostty | ~/Library/Application Support/com.mitchellh.ghostty/config.ghostty, ~/Library/Application Support/com.mitchellh.ghostty/config, ~/.config/ghostty/config.ghostty, ~/.config/ghostty/config |
~/.config/ghostty/config |
~/.config/ghostty/themes/termhint (with --light: termhint-dark and termhint-light) |
New windows have the colors; open windows change after Ghostty menu → Reload Configuration |
| kitty | kitty.conf in $KITTY_CONFIG_DIRECTORY, else in ~/.config/kitty |
The same file | termhint-colors.conf beside it |
Running kitty is asked to reload its config (SIGUSR1) |
| WezTerm | $WEZTERM_CONFIG_FILE, ~/.config/wezterm/wezterm.lua, ~/.wezterm.lua |
$WEZTERM_CONFIG_FILE, else ~/.config/wezterm/wezterm.lua |
~/.config/wezterm/colors/termhint.toml (with --light: termhint-dark.toml and termhint-light.toml) |
WezTerm reloads its config by itself |
| Alacritty | ~/.config/alacritty/alacritty.toml, ~/.alacritty.toml |
~/.config/alacritty/alacritty.toml |
termhint-colors.toml beside it, imported under [general] |
Alacritty reloads its config by itself |
Note: WezTerm: Termhint adds its line before the config's last
return <name>. A config that doesn't end that way is not changed; add<name>.color_scheme = 'termhint'yourself. Alacritty: onlyalacritty.tomlis supported;alacritty migrateconverts analacritty.yml.
File lists and command-line highlighting
--lists(colors.lists):ls, eza, fd, tree and zsh's completion lists get colors throughLS_COLORS,LSCOLORSandCLICOLOR, but only where none are set: your own, or Oh My Zsh's, stay.--syntax(colors.syntax): sets the styles of zsh-syntax-highlighting and zsh-autosuggestions, so comments and suggestions stay readable on a dark background.
Both use the terminal's 16 colors, so they follow the scheme. --no-lists, --no-syntax or
termhint colors off take them back.
Your own scheme
In Settings → Terminal → Colors, Every color edits the window's colors, the 16 colors and the
command line's colors with a color picker. That scheme is custom. It starts as a copy of the
scheme in use (else One Dark); picking a scheme to start from replaces every color. Its colors are
settings too: termhint settings list colors.
A scheme file of your own goes in ~/.config/termhint/colors/<name>.json:
{
"format": 1,
"name": "My Scheme",
"appearance": "dark",
"background": "#2e3440",
"foreground": "#d8dee9",
"cursor": "#eceff4",
"cursor_text": "#282828",
"selection_background": "#eceff4",
"selection_foreground": "#4c566a",
"ansi": ["#3b4252", "#bf616a", "#a3be8c", "#ebcb8b", "#81a1c1", "#b48ead", "#88c0d0", "#e5e9f0",
"#4c566a", "#bf616a", "#a3be8c", "#ebcb8b", "#81a1c1", "#b48ead", "#8fbcbb", "#eceff4"]
}
nameup to 64 characters;appearanceisdarkorlight;creditis optional.ansi: exactly 16 colors: black, red, green, yellow, blue, magenta, cyan, white, then their bright versions.cursor*andselection*are optional: without them the terminal keeps its own.syntaxis optional: colors for the command line, like{ "command": "green", "comment": "#6c7086" }. Parts:command,keyword,string,variable,option,comment,error,glob,operator,suggestion. A value is an ANSI color name (green,bright-black), which follows the scheme, or#rrggbb.
Settings keys
See Settings reference for every key.
| Key | Values | Default |
|---|---|---|
colors.scheme |
off, custom, a scheme id, or a scheme file's path |
off |
colors.light-scheme |
none, a scheme id, or a file's path |
none |
colors.lists |
on, off |
off |
colors.syntax |
on, off |
off |
colors.native.ghostty, .kitty, .wezterm, .alacritty |
on, off |
off |
colors.custom |
a scheme id or file: start the custom scheme again from a copy of it | |
colors.custom.background, .foreground |
#rrggbb |
|
colors.custom.cursor, .cursor-text, .selection-background, .selection-foreground |
#rrggbb, none |
|
colors.custom.<color> (black … white, bright-black … bright-white) |
#rrggbb |
|
colors.custom.syntax.<part> |
an ANSI color name, #rrggbb, default |
default |
All but colors.scheme and the colors.custom* keys need a scheme in use.
Revert to your terminal's colors
termhint colors off # each terminal's own colors, in open tabs too
termhint colors native off all # each terminal config as it was
termhint colors off(or turning Use in my terminals off) gives each terminal its own colors back and takes back what--listsand--syntaxset.termhint colors native off allremoves the marked block from each config and deletes Termhint's color files.termhint uninstall --allalso takes the colors out of each terminal's own config. See Uninstall.