Every key phux binds out of the box.
Press the prefix, C-a, then one of the keys below. Hesitate after the prefix and phux shows this same list in a popup. Every key can be rebound or unbound in [keybindings.prefix-table]; see Key bindings. phux config keys prints the bindings in effect, your changes included.
A capital letter means Shift: X is Shift+x. Where two keys share a row, either one works.
Pane
| Keys | Does | Action |
|---|---|---|
| ” - | Split below | split-pane |
| % | | Split right | split-pane |
| x | Kill pane | kill-pane |
| h j k l | Focus left, down, up, right | focus-direction |
| H J K L | Resize left, down, up, right | resize-pane |
| o | Next pane | next-pane |
| ; | Previous pane | previous-pane |
| = | Last pane | last-pane |
| z | Zoom pane | toggle-zoom |
| [ | Copy mode | copy-mode |
| F | Insert path… | find-path |
| W | Take the wheel | take-input |
| g | Give back the wheel | give-input |
| f | Freeze pane | signal-terminal |
| u | Resume pane | signal-terminal |
Tab
| Keys | Does | Action |
|---|---|---|
| c | New tab | new-window |
| X | Kill tab… | kill-window |
| 0–9 | Go to tab | select-window |
| Tab n | Next tab | next-window |
| p | Previous tab | previous-window |
| w | Go to tab… | window-picker |
| , | Rename tab… | rename-window |
| < | Move tab left | move-window |
| > | Move tab right | move-window |
| G | New tab in folder… | go-to-directory |
Session
| Keys | Does | Action |
|---|---|---|
| C | New session… | new-session |
| s | Go to session… | session-picker |
| N | Next session | next-session |
| P | Previous session | previous-session |
| ) | Last session | last-session |
| $ | Rename session… | rename-session |
| d | Detach | detach |
phux
| Keys | Does | Action |
|---|---|---|
| : ? Space | Command palette | command-palette |
| A | Agents | agent-fleet |
| q | Next waiting pane | next-attention |
| Q | Back where you were | return-from-attention |
| b | Toggle sidebar | toggle-sidebar |
| S | Settings | settings |
| B | Report a bug | report-bug |
| a | Cycle agents filter | agents-filter |
| O | Organize everything | organize |
| R | Resize mode | enter-mode |
Without the prefix
No global bindings ship, so every key without the prefix goes to the program in the pane. Add your own under [keybindings.global].
Key modes
While a mode is on, its keys work without the prefix and the status bar shows its name. Esc leaves any mode that does not bind it. See Key modes.
resize
Press C-a, then R. Keys the mode does not bind do nothing while it is on.
| Keys | Action |
|---|---|
| Down | resize-pane amount=1 direction=down |
| Enter | exit-mode |
| H | resize-pane amount=5 direction=left |
| J | resize-pane amount=5 direction=down |
| K | resize-pane amount=5 direction=up |
| L | resize-pane amount=5 direction=right |
| Left | resize-pane amount=1 direction=left |
| Right | resize-pane amount=1 direction=right |
| Up | resize-pane amount=1 direction=up |
| h | resize-pane amount=1 direction=left |
| j | resize-pane amount=1 direction=down |
| k | resize-pane amount=1 direction=up |
| l | resize-pane amount=1 direction=right |