Skip to main content

​
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

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)

TokenColorUsage
Accent#3FE0A8Signal mint — headings, bullets, links, spinner
Muted#6B6872Whisper — tool responses, timestamps
Success#3FE0A8Signal mint — completed tasks
Warning#F5C06BWarm amber — in-progress tasks, approval prompts
Error#F5A0A0Soft coral — errors, dangerous commands
Info#8AB4F8Soft blue — informational messages
Subtle#2A2732Line — 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.
TokenColorUsage
Accent#0F8F66Deep mint — headings, bullets, links, spinner
Muted#737373Mid grey — tool responses, timestamps
Success#0F8F66Deep mint — completed tasks
Warning#A66A00Darker amber — in-progress tasks, approvals
Error#C4302BCrimson — errors, dangerous commands
Info#1F5BD9Muted blue — informational messages
Subtle#D4D0C7Warm grey — dividers and subtle separators

​
Markdown Styling

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