Themes in BrokenCode

Run /theme to open the selector. You can also set the theme in tui.json for a repeatable user or project preference.

{
  "$schema": "https://brokengpt.com/tui.json",
  "theme": "system"
}

A theme file uses semantic tokens so interface states remain legible. Project and current-directory definitions override a theme with the same name from a broader scope.

• User themes: ~/.config/brokencode/themes/*.json
• Project themes: <project>/.brokencode/themes/*.json
• Current-directory themes: ./.brokencode/themes/*.json

{
  "$schema": "https://brokengpt.com/theme.json",
  "defs": { "accent": "#ff5a2f" },
  "theme": { "primary": "accent" }
}

• Check selected, warning, error, diff, and muted text states.
• Test on the terminal backgrounds your team actually uses.
• Keep syntax and status colors distinguishable without relying on color alone.