Live updates and federation
How the TUI keeps its tables current on its own, and shows every control plane you are logged into in one view.
The TUI is built to be left open. It keeps its tables current without a manual reload, and it shows every control plane you are logged into in one place. This page covers how often the tables refresh and what you see when a control plane cannot be reached.
Live updates
The TUI re-reads every table on a timer, every five seconds by default. Set a
different interval, in seconds, with --refresh. Two things make a table refresh
sooner:
- While a workstation is changing phase, for example starting or stopping, the Workstations tab refreshes every two seconds. The Bindings tab does the same while a binding is still connecting.
- Each action you take in the TUI, such as a start or a delete, refreshes the tables when it finishes.
Press R or Ctrl+R to refresh at once.
Federated control planes
If you have logged into one or more remote control planes, they appear in the TUI alongside your local resources. Each tab merges the rows from every origin you can reach into one table, so your local workstations and the ones on each control plane sit in the same list.
When a remote origin cannot be reached, or its rows fail to merge, the rows that did merge stay visible and a warning line in the footer names the origin that failed. The warning is recomputed on every refresh, so it clears on the next poll once that origin recovers.
Note
rl workstation get -A lists the same merged set
of workstations as the Workstations tab.