CrewCoder TUI themes are JSON files that override the default dark green/charcoal palette.
The loader and built-ins live in @onpoint-dev-tools/crewcoder-tui-core/theme/crewcoder-theme
and are shared with the OpenTUI UI, so the same names and files work in both (see
crewcoder-opentui/docs/THEMES.md for how OpenTUI maps the tokens).
Built-ins:
crewcoder-tui --theme dark
crewcoder-tui --theme light
crewcoder-tui --theme slate # the OpenTUI UI's default paletteEnvironment variable:
CREWCODER_THEME=light crewcoder-tuiTheme file path:
crewcoder-tui --theme ~/.crewcoder/themes/my-theme.jsonNamed custom themes are loaded from:
$CREWCODER_HOME/themes/<name>.json (CREWCODER_HOME defaults to ~/.crewcoder)Example:
crewcoder-tui --theme my-themeCustom themes are merged over the built-in dark theme, or over the built-in named in
extends, so colors may include only the tokens you want to override. The optional
syntax block sets code highlighting colors (keyword, string, number, constant,
comment, function, type, property, operator, punctuation, tag, attribute,
escape), and the optional markdown block sets markdown element colors (heading,
strong, emphasis, strikethrough, code, link, linkUrl, listMarker, quote). The
OpenTUI UI uses both; this UI accepts them but does not use them yet. A full example that
sets every token is crewcoder-opentui/examples/themes/ember.json.
{
"name": "my-theme",
"extends": "dark",
"vars": {
"panel": "#18231f",
"gold": "#f2b84b"
},
"colors": {
"panel": "panel",
"accent2": "gold",
"text": "#e6f3ed"
},
"syntax": {
"keyword": "gold"
}
}Color values support:
- Hex colors:
"#72dfcf" - 256-color indexes:
236 - Variable references from
vars:"gold"
background
backgroundAlt
surface
surfaceAlt
surfaceGlow
panel
panelAlt
panelThinking
selectedBg
diffAddBg
diffDelBg
border
borderStrong
primary
text
muted
subtle
success
warning
danger
accent
accent2
accent3
glowdark,light,crewcoder, andslateare built-in theme names.darkstays the default here.- Invalid theme names or JSON files fail at startup with an error that names the file and the problem; unknown keys are errors.
- Hot reload is not implemented yet; restart the TUI after editing a theme file.
- Assistant messages intentionally render directly on the transcript background without a panel fill or surrounding border.
panelandborderStrongcontinue to style operational surfaces.