Termhint Get Termhint

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

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: only alacritty.toml is supported; alacritty migrate converts an alacritty.yml.

File lists and command-line highlighting

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"]
}

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