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

The current desktop design gives new tasks a wider composer, clearer type, restrained graphite and light colors, compact project navigation, and consistent Apps & MCP icons. The reasoning control shows only levels supported by the selected model.

Open Settings → General → Appearance to choose your theme and fonts. Gentle motion adds short transitions to menus and controls. Turn it off for less movement; the operating system's reduced-motion preference is also respected. Native iPhone and Android screens follow system appearance.

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.