Hotkeys
Buoy is heavily keyboard-driven. Most of the day-to-day operations have a single-letter shortcut, and the few that do not are reachable with a two-key chord. Press ? anywhere in the app to open the live help overlay; it reads from the same keymap as this page.
Single-letter shortcuts fire only when no text input or CodeMirror editor has focus. Modifier-based shortcuts (anything with Cmd, Ctrl, or Alt) work everywhere.
Contents
- Mode and Focus
- Tabs
- Table Navigation
- Selection
- Detail Tabs
- Actions
- Copy Chord
- Go-To Chord
- Zoom
- PromQL Explorer
Mode and Focus
| Key | Action |
|---|---|
:, ; | Focus the command bar. |
Cmd+L | Focus the command bar (alternate). |
Cmd+B | Toggle the navigation sidebar. |
Esc | Blur the command bar, clear the selection, exit select mode, or go back, in that order. |
? | Show the help overlay. |
Tabs
| Key | Action |
|---|---|
Cmd+T | New tab. |
Cmd+W | Close the current tab. |
Cmd+[, Cmd+Left | Back in history. |
Cmd+], Cmd+Right | Forward in history. |
Cmd+1 through Cmd+9 | Switch to the Nth tab. |
Cmd+, | Open Settings. |
Cmd+R | Refresh the active tab. |
| Mouse buttons 4 and 5 | Back and forward (browser-style). |
| Two-finger trackpad swipe | Back and forward on macOS. |
On Linux and Windows, Ctrl substitutes for Cmd everywhere.
Table Navigation
| Key | Action |
|---|---|
j, Down | Cursor down. |
k, Up | Cursor up. |
g g | Jump to the first row. |
G | Jump to the last row. |
Enter, o | Open the detail view, Overview tab. |
d | Open the detail view in describe mode. |
y | Open the detail view, YAML tab. |
l | Open the detail view, Logs tab (Pods only). |
/ | Toggle the in-table filter row. |
The cursor highlight is distinct from the selection highlight. Cursor position is auto-scrolled into view. For virtualized tables (more than about 200 rows), the viewport jumps to fit; otherwise the row scrolls into view normally.
Selection
| Key or click | Action |
|---|---|
x | Toggle selection on the cursor row. Enters select mode if not already in it. |
a | Select every visible row. |
| Click checkbox | Toggle that row. |
| Shift-click checkbox | Range-select from the last clicked checkbox. |
| Header checkbox | Toggle every row in the current sort and filter. |
Esc | Cascading clear: bulk menu first, then selection, then select mode. |
Detail Tabs
Each detail tab has a letter shortcut. Capitalization matters when two tabs would otherwise collide (s for Shell vs. S for Scheduling, r for Related vs. R for Rollout, and so on).
| Key | Tab |
|---|---|
1 to 9 | Jump to the Nth visible tab. |
O | Overview |
y | YAML |
E | Events |
l | Logs (Pod) |
s | Shell (Pod) |
p | Pods (workloads) |
e | Endpoints (Service) |
r | Related |
A | Allocation (Node) |
n | Neighbors (Pod) |
S | Scheduling (Pod) |
R | Rollout |
H | HPA |
V | VPA |
P | Permissions |
Actions
| Key | Action |
|---|---|
m | Open the Actions menu (detail view) or Bulk menu (list view with selection). |
Copy Chord
Press c, then the second key within about 1.2 seconds. Esc cancels a pending chord.
| Chord | Copies |
|---|---|
c l | A deep link (buoy://...) to the current view. |
c k | A kubectl command for the cursor row or selection. |
c t | The visible table as TSV. |
c n | The object name (selection or cursor). |
c y | The YAML of the current detail view. |
A toast confirms the copy: “copied
Go-To Chord
Press g, then the second key within about 1.2 seconds.
| Chord | Action |
|---|---|
g g | Jump to the first table row. |
g c | Open the contexts viewer. |
Zoom
| Key | Action |
|---|---|
Cmd+= | Zoom in (10% steps, up to 2.0x). |
Cmd+- | Zoom out (10% steps, down to 0.7x). |
Cmd+0 | Reset zoom to 1.0x. |
PromQL Explorer
Inside the /prom workspace, the following single-letter shortcuts apply.
| Key | Action |
|---|---|
b | Toggle the structured query builder. |
r | Run the query. |
Cmd+Enter | Run the query from inside the editor. |
t | Toggle chart and table view. |
i | Toggle instant and range mode. |
1 to 6 | Range presets: 5m, 15m, 1h, 6h, 24h, 7d. |
n | Add a new query (B, C, and so on). |
/ | Focus the PromQL editor. |
In the structured builder sidebar:
| Key | Action |
|---|---|
m | Focus the METRIC field. |
a | Focus the AGGREGATION field. |
g | Focus the GROUP BY field. |
F | Focus the FUNCTION (range) field. |
f | Add a new filter. |
Inside the editor itself, Tab accepts or opens the completion popup, Up and Down move through suggestions, Enter accepts, and Esc closes the popup before blurring the editor.