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

# Themes

> Dark and light terminal themes for the orx CLI with automatic detection, per-session overrides via the /theme slash command, and persistence across restarts.

## Theme Support

The orx CLI supports dark and light themes with auto-detection.

## Auto-Detection

The CLI checks these sources in order:

1. `$ORX_THEME` environment variable (`dark` or `light`)
2. `$COLORFGBG` terminal variable (set by iTerm2, xterm, etc.)
3. Falls back to `dark`

## Switching Themes

### Via command

```
/theme          # Toggle current theme
/theme dark     # Switch to dark
/theme light    # Switch to light
```

### Via environment variable

```bash theme={null}
export ORX_THEME=light
orx
```

## Color Palette

Both themes follow the orxhestra brand system — `signal` mint as the primary accent, `whisper` grey for muted text, and supporting colours for success / warning / error states.

### Dark Theme (default)

| Token   | Color     | Usage                                            |
| ------- | --------- | ------------------------------------------------ |
| Accent  | `#3FE0A8` | Signal mint — headings, bullets, links, spinner  |
| Muted   | `#6B6872` | Whisper — tool responses, timestamps             |
| Success | `#3FE0A8` | Signal mint — completed tasks                    |
| Warning | `#F5C06B` | Warm amber — in-progress tasks, approval prompts |
| Error   | `#F5A0A0` | Soft coral — errors, dangerous commands          |
| Info    | `#8AB4F8` | Soft blue — informational messages               |
| Subtle  | `#2A2732` | Line — dividers and subtle separators            |

### Light Theme

The light theme uses a deeper mint for the accent so it meets WCAG AA contrast (≥ 4.5:1) against white backgrounds — pure signal is too pastel for small terminal text on light surfaces.

| Token   | Color     | Usage                                         |
| ------- | --------- | --------------------------------------------- |
| Accent  | `#0F8F66` | Deep mint — headings, bullets, links, spinner |
| Muted   | `#737373` | Mid grey — tool responses, timestamps         |
| Success | `#0F8F66` | Deep mint — completed tasks                   |
| Warning | `#A66A00` | Darker amber — in-progress tasks, approvals   |
| Error   | `#C4302B` | Crimson — errors, dangerous commands          |
| Info    | `#1F5BD9` | Muted blue — informational messages           |
| Subtle  | `#D4D0C7` | Warm grey — dividers and subtle separators    |

## Markdown Styling

Rich Markdown elements (blockquotes, bullets, headings, links) use the theme accent color instead of terminal defaults.