Skip to content

TUI Dashboard

The TUI dashboard provides a real-time terminal interface for monitoring profile health, viewing metrics, and quickly launching Claude Code sessions.

Terminal window
# Explicit launch
claudex dashboard
# Auto-launch (when profiles exist and no subcommand given)
claudex
KeyAction
j / Move selection down
k / Move selection up
EnterLaunch Claude Code with selected profile
tTest connectivity for selected profile
aAdd new profile (shows hint)
dDelete selected profile (shows hint)
pToggle proxy start/stop
/Enter search mode
EscExit search mode / close help
?Show help popup
q / Ctrl+CQuit dashboard

The dashboard displays:

  • Profile list — All configured profiles with name, model, provider type, and health status
  • Health indicators — Color-coded status (green = healthy, yellow = degraded, red = circuit breaker open)
  • Metrics panel — Per-profile request count, success rate, average latency
  • Log panel — Real-time scrolling log output

The dashboard runs a background health checker that pings all enabled profiles every ~30 seconds. Health status is reflected in real time:

ColorMeaning
GreenProvider is responding normally
YellowRecent failures detected
RedCircuit breaker is open
GrayProfile is disabled