detached 84a7898

docs(readme): document command palette keys

commit
84a7898a0d2d6a536bad950c8d697bde7ce53fc2
author
brice · · 2026-07-03 05:47 UTC
committer
brice · · 2026-07-03 07:35 UTC
parent
46fa9b3
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
1 file · +17 -8
M README.md +17 -8
@@ -44,14 +44,23 @@ All bindings use the Alt modifier directly, no prefix key.
4444
4545 | Key | Action |
4646 |---|---|
47-| Alt+c | new tab |
48-| Alt+n / Alt+p | next / previous tab |
49-| Alt+1 .. Alt+9 | select tab by number |
50-| Alt+x | close tab (last tab ends the session) |
51-| Alt+d | detach |
52-| Alt+r | promote the current ephemeral session to named |
53-| Alt+t | open session/tab picker |
54-| Alt+u | enter scrollback mode |
47+| Alt+Space | open the command palette |
48+| Alt+1 .. Alt+9 | switch to tab by number |
49+
50+## Command palette
51+
52+Open the palette with Alt+Space, then type a command code or fuzzy-match its label. Use Up/Down or Ctrl-N/Ctrl-P to move through matches, Enter to run the selected command, and Esc to close the palette. Some terminals emit NBSP for Alt+Space; in those terminals the binding depends on terminal configuration.
53+
54+| Code | Action |
55+|---|---|
56+| CNT | create new tab |
57+| CLT | close current tab |
58+| NXT | switch to next tab |
59+| PVT | switch to previous tab |
60+| SSP | switch session or tab |
61+| CPY | enter scrollback mode |
62+| RNS | rename session |
63+| DET | detach |
5564
5665 ## Scrollback and visual copy
5766
@@ -44,14 +44,23 @@ All bindings use the Alt modifier directly, no prefix key.
44 44
45 | Key | Action |45 | Key | Action |
46 |---|---|46 |---|---|
47-| Alt+c | new tab |47+| Alt+Space | open the command palette |
48-| Alt+n / Alt+p | next / previous tab |48+| Alt+1 .. Alt+9 | switch to tab by number |
49-| Alt+1 .. Alt+9 | select tab by number |49+
50-| Alt+x | close tab (last tab ends the session) |50+## Command palette
51-| Alt+d | detach |51+
52-| Alt+r | promote the current ephemeral session to named |52+Open the palette with Alt+Space, then type a command code or fuzzy-match its label. Use Up/Down or Ctrl-N/Ctrl-P to move through matches, Enter to run the selected command, and Esc to close the palette. Some terminals emit NBSP for Alt+Space; in those terminals the binding depends on terminal configuration.
53-| Alt+t | open session/tab picker |53+
54-| Alt+u | enter scrollback mode |54+| Code | Action |
55+|---|---|
56+| CNT | create new tab |
57+| CLT | close current tab |
58+| NXT | switch to next tab |
59+| PVT | switch to previous tab |
60+| SSP | switch session or tab |
61+| CPY | enter scrollback mode |
62+| RNS | rename session |
63+| DET | detach |
55 64
56 ## Scrollback and visual copy65 ## Scrollback and visual copy
57 66

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 12

Tags 11

↑↓ moveenter openesc close