TUI picker
Choose the dark or light theme in config with theme = "light", or switch it live with /theme light. Automation can use lazy-tmux hook theme light.
Actions are organized into color-coded modes. Type / to open the command palette, or use the shortcut for a mode directly. While a mode is active the whole frame recolors (red for delete, blue for rename, green for new, cyan for wake/sleep), the list is filtered to the targets that mode can act on, and Esc returns to the resting browse mode. Press ? for the full keybinding cheat sheet.
| Key | Action |
|---|---|
Type | Fuzzy search sessions and windows. |
/ | Open the command palette: /delete, /rename, /new, /wake, /sleep. Tab completes, Enter runs the highlighted command and enters its color-coded mode. |
? | Toggle a full keybinding cheat sheet (only when the search box is empty; any key closes it). |
<C-j> | Move down to the next selectable row. |
<C-k> | Move up to the previous selectable row. |
Enter | Restore the selected target — or, inside a mode, perform that mode's action. |
<Option/Alt-1..9> | Immediately restore the first matching window with that tmux index in the current search results. |
Esc | Cancel the active mode and return to browse; in browse mode, close the picker. |
<C-c>, <C-q> | Cancel and close the picker. |
Space | In delete mode, mark or unmark the row under the cursor. Marking a session marks all of its windows, so a fully-marked session is deleted as a whole. |
<C-d> | Enter delete mode with the window under the cursor already marked. |
<Alt-d> | Enter delete mode with the whole session under the cursor marked. |
<C-r> | Enter rename mode on the window under the cursor. |
<Alt-r> | Enter rename mode on the session that owns the window under the cursor. |
<C-n> | Enter new mode to add a window to the session under the cursor. |
<Alt-n> | Enter new mode to create a fresh session. |
<Alt-w> | Enter wake mode (sleeping sessions only): restore a saved session that is not running. |
<Alt-s> | Enter sleep mode (live sessions only): save a running session's state and close it. |