Keybindings
bext-tui is keyboard-driven by design. The defaults are vim-flavored but should feel familiar even if you've never used vim.
Press ? inside the TUI for a context-sensitive overlay showing only the bindings active in the current view.
Global#
| Key | Action |
|---|---|
q |
Quit |
? |
Toggle the help overlay |
: |
Open the command palette |
/ |
Filter / search in the current view |
Esc |
Close overlay, cancel input, or go back |
Ctrl+r |
Force-refresh all data right now |
Ctrl+l |
Force a full screen redraw (clear + repaint) |
Tab navigation#
| Key | Action |
|---|---|
1 … 9 |
Jump to view by number (1=Dashboard, 2=Sites, …) |
Tab |
Next view |
Shift+Tab |
Previous view |
g-prefix view jumps#
Press g, then a letter:
| Chord | View |
|---|---|
gd |
Dashboard |
gs |
Sites |
gr |
Requests |
gc |
Cache |
gw |
Workers |
gt |
TLS |
gp |
Proxy |
gf |
WAF (firewall) |
gy |
Deploy |
gl |
Logs |
go |
Config |
gg |
Jump to first row in current list |
List / table navigation#
These work in any view that has a selectable list (Sites, Requests, Workers, TLS, Proxy, WAF, Deploy, Logs):
| Key | Action |
|---|---|
j / Down |
Select next row |
k / Up |
Select previous row |
gg |
Jump to first row |
G |
Jump to last row |
Ctrl+d |
Page down |
Ctrl+u |
Page up |
Enter |
Drill into detail / open popup |
Space |
Toggle select (or pause in Requests) |
View-specific actions#
Sites#
| Key | Action |
|---|---|
Enter |
Open / close site detail |
h / l |
Cycle detail tab left / right (when detail is open) |
d |
Deploy this site |
r |
Rollback this site |
s |
Stop / start this site |
p |
Purge this site's cache |
Requests#
| Key | Action |
|---|---|
Space |
Pause / resume the live stream |
/ |
Filter by path / host / status |
Enter |
Open request detail popup |
Cache#
| Key | Action |
|---|---|
p |
Purge all (confirmed) |
P |
Purge by pattern |
w |
Pre-warm cache |
Workers#
| Key | Action |
|---|---|
r |
Restart the selected worker |
R |
Restart all workers of the selected kind |
TLS#
| Key | Action |
|---|---|
r |
Force renew the selected certificate |
p |
Provision a new certificate (input) |
Enter |
Show certificate detail |
Proxy#
| Key | Action |
|---|---|
h |
Health-check the selected upstream now |
d |
Drain the selected upstream |
Enter |
Open upstream detail |
WAF#
| Key | Action |
|---|---|
e |
Toggle the selected rule (enable / disable) |
Deploy#
| Key | Action |
|---|---|
d |
Deploy the selected site |
r |
Rollback the selected deployment |
p |
Promote a canary to stable |
Config#
| Key | Action |
|---|---|
r |
Hot-reload bext.config.toml |
v |
Re-run validation |
Confirmation prompts#
When a destructive or high-impact action is triggered, a modal asks for confirmation:
| Key | Action |
|---|---|
y / Y / Enter |
Confirm |
n / N / Esc |
Cancel |
Filter input#
When you press / to filter:
| Key | Action |
|---|---|
| Any printable character | Append to the filter |
Backspace |
Delete one character |
Ctrl+u |
Clear the filter |
Enter |
Apply the filter and exit input mode |
Esc |
Cancel and clear the filter |
Command palette input#
When you press ::
| Key | Action |
|---|---|
| Any printable character | Append to the query |
Up / Down / Tab / Shift+Tab |
Cycle through suggestions |
Enter |
Run the selected command |
Esc |
Cancel |
See Command palette for the full list of registered commands.
Tip
Press ? inside the TUI for a context-sensitive overlay that only shows bindings active in the current view — handy when you can't remember which letter does what in a specific panel.
Related#
- TUI Views — the screens these keybindings act on
- TUI Command Palette — the alternative to keybindings for less-used actions
- TUI Configuration —
--mouseflag to enable click-to-select as a complement