Terminal UI

A full-screen dashboard for watching and managing your resources from the terminal.

rl tui puts your Ringleader resources into one full-screen interface in the terminal that you can act on: workstations, configs, bindings, SSH keys, and grants. Each row shows its current status and can be acted on in place, so a workstation can be started, stopped, restarted, or shelled into without leaving the view. If you have used k9s for Kubernetes, it is the same idea.

rl tui

Launch the dashboard. Control planes you have signed into appear alongside your local resources.

rl tui                             # all namespaces you can see
rl tui -n team-blue                # scope to one namespace
rl tui --theme dark --refresh 3
FlagDescription
--theme <theme>Color theme: auto (default), dark, light, basic.
--refresh <seconds>How often the tables refresh, in seconds (default 5).
-n, --namespace <ns>Namespace (default: all).
-A, --all-namespacesAll namespaces (equivalent to -n "").
--as <subject>Impersonate a subject.
--home <dir>Data directory.

The TUI is a convenience layer over the same resource API the other commands use. Anything you can see there you can also reach with get and friends.

Note

This page is the command summary. For a full walkthrough (navigation, per-view actions, the create wizard, describe and troubleshoot, filtering, and live federation) see the dedicated Terminal UI section.