Terminal UI & Dashboard

codex auth

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Codex Multi-Auth Dashboard
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Quick Start
  › Add account                                  (green)
  › Check accounts                               (green)
  › Find best account                            (green)
  › Fix issues                                   (green)
  › Settings                                     (green)

  Accounts
◆ 1. [email protected] [current] [ok]
    Last used: today | Limits: 5h ██████████ 45% | 7d ████████░░ 78%

  2. [email protected] [rate-limited]
    Last used: 2h ago | Limits: 5h ██░░░░░░░░ 12% reset 4m 23s

  3. [email protected] [ok]
    Last used: yesterday | Limits: 5h ████████░░ 82%

  Danger Zone
  › Remove all accounts                          (red)

Help: ↑/↓ navigate • Enter select • 1-9 quick switch • / search • ? help • q quit

# Press / to enter search mode
Search: alice

# Shows only matching accounts
◆ 1. [email protected] [current] [ok]

# Press Esc or Enter blank to clear search

interface UiTheme {
  profile: 'ansi16' | 'ansi256' | 'truecolor';  // Color depth
  glyphMode: 'ascii' | 'unicode' | 'auto';      // Character set
  palette: 'green' | 'blue';                    // Color scheme
  accent: 'green' | 'cyan' | 'blue' | 'yellow'; // Accent color
}

// Detects terminal capabilities from environment
const profile = detectColorProfile();
// Checks: COLORTERM, TERM, WT_SESSION, etc.

# Unicode (default for modern terminals)
◆ Selected
○ Unselected
• Bullet
✓ Success
✗ Error

# ASCII (fallback for older terminals)
> Selected
o Unselected
- Bullet
+ Success
x Error

const isUnicodeSafe = 
  process.env.WT_SESSION ||           // Windows Terminal
  process.env.TERM_PROGRAM === 'vscode' || // VS Code
  process.env.TERM?.includes('xterm');      // xterm-compatible

{
  primary: 'rgb(74, 222, 128)',   // Success actions
  success: 'rgb(74, 222, 128)',   // Healthy accounts
  border: 'rgb(34, 197, 94)',     // Focus borders
  focusBg: 'rgb(22, 101, 52)',    // Selected background
}

{
  primary: 'rgb(96, 165, 250)',   // Success actions
  success: 'rgb(96, 165, 250)',   // Healthy accounts
  border: 'rgb(59, 130, 246)',    // Focus borders
  focusBg: 'rgb(37, 99, 235)',    // Selected background
}

// Green accent (default)
accentColor: 'rgb(74, 222, 128)'

// Cyan accent
accentColor: 'rgb(34, 211, 238)'

// Blue accent
accentColor: 'rgb(59, 130, 246)'

// Yellow accent
accentColor: 'rgb(245, 158, 11)'

codex auth
# Select "Settings" → "Theme"

# Entire row highlighted with inverted background
◆ 1. [email protected] [current] [ok]
  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ (highlighted)
  2. [email protected] [rate-limited]
  3. [email protected] [ok]

# Compact chip indicator next to item
◆ 1. [email protected] [current] [ok]
  2. [email protected] [rate-limited]
  3. [email protected] [ok]

// In settings or account display
focusStyle: 'row-invert' | 'chip'

// Truecolor
[ok]         → rgb(74, 222, 128) background
[disabled]   → rgb(239, 68, 68) background

// ANSI 16
[ok]         → \x1b[42m (green background)
[disabled]   → \x1b[41m (red background)

# Healthy (70%+ remaining)
5h ██████████ 78% | 7d █████████░ 92%
   ^^^^^^^^^^ green

# Warning (35-70% remaining)
5h █████░░░░░ 45% | 7d ████░░░░░░ 38%
   ^^^^^^^^^^ yellow

# Critical (<35% remaining)
5h ██░░░░░░░░ 12% reset 4m 23s | 7d █░░░░░░░░░ 8%
   ^^^^^^^^^^ red

function quotaToneFromLeftPercent(percent: number) {
  if (percent <= 15) return 'danger';    // Red
  if (percent <= 35) return 'warning';   // Yellow
  return 'success';                      // Green
}

// Default fields (customizable order)
statuslineFields: ['last-used', 'limits', 'status']

// Rendered output
Last used: today | Limits: 5h ██████████ 45% | Status: ok

const account: AccountInfo = {
  statuslineFields: ['limits', 'last-used'],  // Custom order
  showHintsForUnselectedRows: true,           // Show on all rows
};

codex auth
# Select "Settings"

// Queued writes with retry on EBUSY/EPERM (Windows safe)
await saveSettings(updated);
// Max 4 retries with exponential backoff: 10ms, 20ms, 40ms, 80ms

# When piped or redirected, falls back to CLI output
codex auth | tee output.log
# Output:
# Account 1: [email protected] (active, ok)
# Account 2: [email protected] (rate-limited)
# Account 3: [email protected] (ok)

export function isTTY(): boolean {
  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
}

refreshIntervalMs: 200  // Update quota bars every 200ms