Color Themes

Color Themes

a9s ships with 11 built-in color themes, extracted to ~/.a9s/themes/ on first launch. The default is Tokyo Night Dark.

Switching Themes

At runtime: Press : and type theme to cycle through available themes.

In config: Set the theme in ~/.a9s/config.yaml:

theme: "dracula.yaml"

Built-in Themes

Theme	Background
tokyo-night.yaml (default)	Dark
catppuccin-mocha.yaml	Dark
dracula.yaml	Dark
nord.yaml	Dark
gruvbox-dark.yaml	Dark
solarized-dark.yaml	Dark
tokyo-night-light.yaml	Light
catppuccin-latte.yaml	Light
nord-light.yaml	Light
gruvbox-light.yaml	Light
solarized-light.yaml	Light

Match your theme to your terminal background for best results.

Creating a Custom Theme

Copy any built-in file from ~/.a9s/themes/ and edit the colors:

name: "My Theme"
colors:
  header_fg: "#f8f8f2"
  accent: "#bd93f9"
  dim: "#6272a4"
  border: "#44475a"
  row_selected_bg: "#bd93f9"
  row_selected_fg: "#282a36"
  row_alt_bg: "#21222c"
  running: "#50fa7b"
  stopped: "#ff5555"
  pending: "#f1fa8c"
  terminated: "#6272a4"
  detail_key: "#bd93f9"
  detail_val: "#f8f8f2"
  detail_sec: "#f1fa8c"
  yaml_key: "#bd93f9"
  yaml_str: "#50fa7b"
  yaml_num: "#ffb86c"
  yaml_bool: "#ff79c6"
  yaml_null: "#6272a4"
  yaml_tree: "#44475a"
  help_key: "#50fa7b"
  help_cat: "#f1fa8c"
  filter: "#f1fa8c"
  success: "#50fa7b"
  error: "#ff5555"
  spinner: "#bd93f9"
  scroll: "#44475a"
  warning: "#f1fa8c"
  key_hint_key: "#bd93f9"
  key_hint_bg: "#21222c"
  key_hint_fg: "#6272a4"
  overlay_bg: "#282a36"
  overlay_border: "#bd93f9"
  search_highlight_fg: "#282a36"
  search_highlight_bg: "#f1fa8c"

All values are hex color codes. Save as ~/.a9s/themes/my-theme.yaml and set theme: "my-theme.yaml" in config.

Color Key Reference

Key	Where it appears
header_fg	Top bar text
accent	Highlighted elements, active items
dim	Muted/secondary text
border	View borders and separators
row_selected_bg/fg	Currently selected row
row_alt_bg	Alternating row stripe
running/stopped/pending/terminated	Resource status colors
detail_key/val/sec	Detail view: field names, values, section headers
yaml_key/str/num/bool/null/tree	YAML/JSON syntax highlighting
help_key/cat	Help screen: key bindings, category headers
filter	Active filter/search text
success/error/warning	Status messages
spinner	Loading indicator
scroll	Scroll indicators
key_hint_key/bg/fg	Bottom key hints bar
overlay_bg/border	Modal overlays (command palette, etc.)
search_highlight_fg/bg	Search match highlighting

Partial Themes

You don't need to specify every color. Missing colors inherit from Tokyo Night Dark. This lets you create a theme that only overrides what you care about:

name: "Minimal Override"
colors:
  accent: "#ff6600"
  running: "#00ff00"

Monochrome Mode

Set the NO_COLOR environment variable to force monochrome output regardless of theme:

NO_COLOR=1 a9s

Resetting Themes

a9s --reset-themes  # delete all theme files, regenerate built-in defaults on next launch