> ## Documentation Index
> Fetch the complete documentation index at: https://docs.commanderplugin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Themes — 10 Visual Themes for CC Commander TUI

> All 10 visual themes available in CC Commander, what each theme affects, how to switch themes, and how to disable color output for CI environments.

CC Commander ships with 10 visual themes that change the look of the interactive TUI. Each theme sets the gradient colors for ASCII art, the primary and accent palette for menus and borders, the spinner style, and the success/error indicator colors. You get a live preview as you navigate — no restart required.

## Switching Themes

<Tabs>
  <Tab title="Interactive menu">
    Open CC Commander and navigate to **Settings → Theme**. Themes preview in real time as you scroll through the list.
  </Tab>

  <Tab title="Dispatch command">
    From the CLI or inside a Claude Code session:

    ```bash theme={null}
    ccc --dispatch "switch theme"
    ```
  </Tab>

  <Tab title="In-session command">
    Type `/ccc:theme` in any active Claude Code session to open the theme picker without leaving the session.
  </Tab>
</Tabs>

Your chosen theme is persisted in `~/.claude/commander/state.json` and loads automatically on the next `ccc` launch.

***

## All 10 Themes

<CardGroup cols={2}>
  <Card title="Cyberpunk" icon="bolt">
    **Default theme.** Cyan primary, hot-pink secondary, deep-purple accent. Rounded borders. High-contrast neon palette on a near-black background. Inspired by terminal aesthetics of the 1980s science fiction genre.
  </Card>

  <Card title="Fire">
    Amber primary, deep-orange secondary, bright-yellow accent. Heavy borders. Warm gradient from gold to red in the logo. Best on dark terminal backgrounds.
  </Card>

  <Card title="Graffiti">
    Yellow primary, hot-pink secondary, sky-blue accent. Single-line borders. Three-stop gradient (yellow → pink → cyan) in the ASCII logo. High-energy, street-art palette.
  </Card>

  <Card title="Futuristic">
    Periwinkle primary, lavender secondary, mint accent. Rounded borders. Soft blue-purple gradient. A quieter high-tech look for extended work sessions.
  </Card>

  <Card title="Ocean">
    Sky-blue primary, seafoam secondary, teal accent. Rounded borders. Three-stop gradient (sky-blue → seafoam → deep-blue) in the logo. Cool and easy on the eyes.
  </Card>

  <Card title="Aurora">
    Bright-green primary, cyan secondary, violet accent. Rounded borders. Three-stop gradient (green → cyan → purple) that mimics northern lights. Vibrant but balanced.
  </Card>

  <Card title="Sunset">
    Warm-orange primary, hot-pink secondary, golden-yellow accent. Heavy borders. Three-stop gradient (red-orange → gold → pink) in the logo. Rich warm palette.
  </Card>

  <Card title="Monochrome">
    Light-gray primary, mid-gray secondary, white accent. Single-line borders. Two-stop gradient (gray → white). Clean and minimal — reduces visual noise during long sessions.
  </Card>

  <Card title="Rainbow">
    Cyan primary, magenta secondary, yellow accent. Rounded borders. Six-stop full-spectrum gradient across the logo. Maximum color expression.
  </Card>

  <Card title="Dracula">
    Soft-purple primary, pink secondary, light-blue accent. Rounded borders. Two-stop gradient (purple → pink). Based on the popular Dracula color scheme with its near-black highlight background.
  </Card>
</CardGroup>

***

## What Themes Affect

| Element              | How Themes Change It                                         |
| -------------------- | ------------------------------------------------------------ |
| ASCII logo gradient  | Each theme sets its own multi-stop RGB gradient and font     |
| Menu item highlights | Primary and secondary colors applied to selected rows        |
| Border style         | Each theme specifies `rounded`, `heavy`, or `single` borders |
| Spinner              | Inherits the theme's primary color                           |
| Success indicators   | Bright green (most themes) or theme-specific                 |
| Error indicators     | Bright red (most themes) or theme-specific                   |
| Dim text             | Varies by theme — affects unselected items and labels        |

CC Commander ships four base themes (`Cyberpunk`, `Fire`, `Graffiti`, `Futuristic`) and six extended themes (`Ocean`, `Aurora`, `Sunset`, `Monochrome`, `Rainbow`, `Dracula`). All 10 are available immediately after install.

***

## Disabling Colors

If you are running CC Commander in a CI/CD pipeline, a log aggregator, or a terminal that does not support ANSI codes, disable all color output:

```bash theme={null}
CC_NO_COLOR=1 ccc --dispatch "run tests" --json
```

Setting `CC_NO_COLOR=1` suppresses all ANSI escape codes — gradients, theme colors, spinner animations, and status bar formatting. The output is plain text suitable for logging.

`CC_NO_ANIMATION=1` disables spinners and gradient animations but preserves static color if you want colored output without moving parts.

<Tip>
  CC Commander auto-detects common CI environment variables and suppresses animations automatically. Set `CC_NO_COLOR=1` explicitly when you also need to strip color codes from log output.
</Tip>
