Appearance
Themes
Pick one in Settings → Appearance (ctrl+b s, or Settings in the activity bar): click a theme and it applies at once; ↶ Back to … returns to the one you had. It saves [theme] name in config.toml and every part of Ghosted recolours straight away.
When the window shows a machine whose Ghosted has no Settings view (older, or Windows), ctrl+b s opens the window's own Settings instead: moving through its theme list with the arrow keys previews each one; choose one to keep it.
18 built-in themes: catppuccin (default), catppuccin-latte, terminal (your terminal's own colours), tokyo-night, tokyo-night-day, dracula, nord, gruvbox, gruvbox-light, one-dark, one-light, solarized, solarized-light, kanagawa, kanagawa-lotus, rose-pine, rose-pine-dawn, vesper.
The terminal window
While Ghosted is open, the terminal it runs in (Ghostty, iTerm2, kitty…) takes the theme's background and foreground colours, and gets its own back when Ghosted closes. To keep your terminal's colours:
toml
[theme]
terminal_colors = falseYour own themes
One file per theme in ~/.config/ghosted/themes/<name>.toml. It starts from a built-in theme and changes only what you list:
toml
base = "tokyo-night" # any built-in; default catppuccin
accent = "#ff9e64"
bar_bg = "#16161e"
card_bg = "#1f2335"
lane1 = "#7aa2f7"It shows up in the Settings list under its file name. The same keys work in [theme.custom] (and [theme.custom.dark] / [theme.custom.light]) in config.toml to adjust whichever theme is active.
Colour names
Base colours: accent panel_bg sidebar_bg active_row_bg selection_bg surface0 surface1 surface_dim overlay0 overlay1 text subtext0 mauve green yellow red blue teal peach.
Colours named by their job. Leave one out and it is worked out from the base:
| Name | What it colours | Default |
|---|---|---|
background, foreground | the terminal window Ghosted runs in | surface_dim, text |
bar_bg | activity bar | sidebar_bg |
popup_bg, tab_bar_bg | popups, tab bar | panel_bg |
card_bg, card_hover | cards and buttons (the views) | surface0, surface1 |
muted | quiet text | overlay0 |
diff_added, diff_removed | changed lines | green, red |
diff_added_bg, diff_removed_bg | changed line backgrounds | green / red faded into surface_dim |
lane1..lane8 | Git Graph branch lanes | blue green peach mauve teal yellow red accent |
ansi0..ansi15 | the 16 terminal colours inside panes | from the base colours |
Colours are #rrggbb, #rgb, rgb(r, g, b), a colour name, or reset (the terminal's own).
Panes
Shells and agents keep your terminal's colours unless you turn this on:
toml
[theme]
panes = true # recolour the 16 terminal colours with ansi0..ansi15For plugins
Ghosted writes the resolved theme to the file named by GHOSTED_THEME_FILE (~/.local/state/ghosted/theme.json) whenever it changes: {"name", "available", "colors": {name: "#rrggbb" | "reset" | "ansi:N"}}, with every name above filled in.