Skip to content
osctrlosctrlosctrl

tui

osctrl-cli tui (alias dashboard) opens a full-screen terminal dashboard — fleet health, platforms, environments, queries, and audit log — refreshed automatically every 30 seconds. It works in both --db and --api mode.

$ ./osctrl-cli tui -h
NAME:
   osctrl-cli tui - Full-screen TUI dashboard — fleet health, platforms, environments, queries, audit


USAGE:
   osctrl-cli tui [options]


OPTIONS:
   --help, -h  show help


GLOBAL OPTIONS:
   --db, -d                           Connect to local osctrl DB using YAML config file [$DB_CONFIG]
   --api, -a                          Connect to remote osctrl using JSON config file [$API_CONFIG]
   --api-file FILE, -A FILE           Load API JSON configuration from FILE (default: "osctrl-api.json") [$API_CONFIG_FILE]
   --api-url string, -U string        The URL for osctrl API to be used [$API_URL]
   --api-token string, -T string      Token to authenticate with the osctrl API [$API_TOKEN]
   --db-file FILE, -D FILE            Load DB YAML configuration from FILE [$DB_CONFIG_FILE]
   --db-host string                   Backend host to be connected to (default: "127.0.0.1") [$DB_HOST]
   --db-port int                      Backend port to be connected to (default: 5432) [$DB_PORT]
   --db-name string                   Database name to be used in the backend (default: "osctrl") [$DB_NAME]
   --db-user string                   Username to be used for the backend (default: "postgres") [$DB_USER]
   --db-pass string                   Password to be used for the backend (default: "postgres") [$DB_PASS]
   --db-max-idle-conns int            Maximum number of connections in the idle connection pool (default: 20) [$DB_MAX_IDLE_CONNS]
   --db-max-open-conns int            Maximum number of open connections to the database (default: 100) [$DB_MAX_OPEN_CONNS]
   --db-conn-max-lifetime int         Maximum amount of time a connection may be reused (default: 30) [$DB_CONN_MAX_LIFETIME]
   --insecure, -i                     Allow insecure server connections when using SSL
   --verbose, -V                      Increase output verbosity for debugging
   --output-format string, -o string  Format to be used for data output (default: "pretty") [$OUTPUT_FORMAT]
   --silent, -s                       Silent mode
   --version, -v                      Print version information
Terminal window
$ ./osctrl-cli tui --db -D db.yml
$ ./osctrl-cli dashboard --api -A osctrl-api.json

Keys

Section titled “Keys”
Key Action
1 Environments pane
2 Queries pane
3 Audit log pane
r Refresh now
q / Ctrl-C Quit