TUI dashboard

Operate providers, models, groups, chat, keys, logs, configuration, metrics, and AI diagnostics from the terminal.

Start the TUI

Terminal

modelmux tui

The TUI reads the same configuration as the proxy and provides a terminal-native operational interface. Some actions update configuration and reload the router.

Dashboard pages

Page	Purpose
Providers	Inspect upstream routes and provider state.
Models	Inspect routable model IDs and strategy settings.
Groups	Inspect aliases and their model/key members.
Chat	Run in-memory prompt sessions against configured models or groups.
Keys	Inspect live key state, cooldowns, usage, and errors.
Logs	View and filter recent request history.
Config	Edit the YAML-backed configuration through forms and selectors.
AI	Inspect classification, guardrails, route diagnostics, and related tools.

Global navigation

Shortcut	Action
`tab / shift+tab`	Move between main pages.
`enter`	Open the selected page or item.
`esc`	Cancel input, close a dialog, or return to the previous level.
`?`	Toggle help when not typing.
`q`	Quit when not typing.
`ctrl+c`	Force quit.
`t`	Cycle the active color theme.
`T`	Open the theme picker.

Chat shortcuts

Shortcut	Action
`enter`	Open a selected session or send the current message.
`up / down`	Select a chat session.
`pgup / pgdown`	Scroll conversation history.
`ctrl+n`	Create a new chat session.
`ctrl+t`	Switch the target model or group.
`ctrl+f`	Filter sessions.
`esc`	Clear input or return to the session list/menu.

Configuration shortcuts

Shortcut	Action
`up / down`	Select a configuration row.
`left / right`	Switch sections or open a selectable field.
`enter`	Edit the selected item.
`space`	Toggle an item in a multi-select popup.
`a`	Add an item.
`delete`	Delete the selected item.
`ctrl+s`	Save configuration and reload the router.
`ctrl+r`	Reload the draft configuration.
`/ or ctrl+f`	Filter configuration rows.

Operational shortcuts

Area	Shortcut	Action
Keys	`1 / 2 / 3`	Sort by status, cooldown, or errors.
Keys	`x`	Test a key by ID.
Logs	`1–6`	Change log filter or sort order.

Single-letter navigation is disabled while typing into text fields so normal text entry is not intercepted.