Terminal UI

vxl with no arguments opens the interactive terminal UI. It talks to the daemon over the same gRPC connection as the CLI, using the server profile you selected.

Connect

$ vxl server use prod
$ vxl

The TUI uses the default server profile. To use another, pass --connect with the daemon address, or change the default profile with vxl server use. When the profile uses --ssh-tunnel, the TUI opens the same authenticated SSH stdio channel.

Sections

The left rail contains:

  • dashboard, projects, deployments
  • databases, compose, secrets
  • monitoring, tunnel, plugins
  • api-keys, ai-ops, settings

The plugins section reports that the plugin service is not available in the Community build. The ai-ops section reports that the agent is not configured until the AI preview is enabled.

Keys

KeyAction
tabCycle focus between the rail and the content.
left, hMove focus left.
right, lMove focus right.
up, down, k, jNavigate a list.
enterOpen or select.
?Open the help overlay for the current section.
ctrl+rOpen the session browser.
ctrl+oCycle SRE mode.
q, ctrl+cQuit from the rail.

Projects and deployments

  • n creates a project; p deploys; d deletes.
  • r rolls back the selected project or deployment.
  • l opens live logs for a deployment.
  • R refreshes.

Databases and secrets

  • In databases, n creates a database and s shows the connection string. That string contains a secret.
  • In secrets, s sets a value, r rotates it andd deletes it.

Monitoring and AI

  • In monitoring, / edits the log query and Enter runs it.
  • In ai-ops, Enter submits and Esc cancels.

Press ? inside a section to see its full binding list.

Themes

$ vxl tui --theme nord

Available themes are dark, light, synthwave,nord and gruvbox. The default is dark.

Serve the TUI over SSH

vxl tui --serve starts an SSH server for the TUI. It listens on port2222 by default and reads the authorized keys file passed with--authorized-keys. This is separate from the daemon's own[ssh] listener.

$ vxl tui --serve --authorized-keys ~/.ssh/authorized_keys --ssh-port 2222