detached 611ca87

docs(readme): document recent session jumps

commit
611ca876ef32f3269f19b4597e0cbdabe60209b0
author
brice · · 2026-07-11 12:30 UTC
parent
e2e231b
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
1 file · +3 -1
M README.md +3 -1
@@ -108,6 +108,7 @@ code.focus-pane-down = FPD
108108 code.next-tab = NXT
109109 code.previous-tab = PVT
110110 code.back-session = BSK
111+code.jump-recent-session = JRS
111112 code.session-picker = SSP
112113 code.visual-mode = VIS
113114 code.toggle-floating-pane = FLT
@@ -179,7 +180,7 @@ Some terminals encode Alt+Space as a non-breaking space instead of `ESC Space`;
179180
180181 Open the palette with Alt+Space. Type a command code or fuzzy-match the label/description. Use Up/Down or Ctrl-N/Ctrl-P to move, Enter to run, and Esc/Ctrl-C to close.
181182
182-Successful commands are promoted near the top the next time the palette opens.
183+Successful commands are promoted near the top the next time the palette opens. `BSK` toggles only this client's previously active session. Type an exact `JRS` token to show the current interaction's immutable recent-session ranks; `JRS N` jumps to rank N. Invalid or stale ranks leave the palette open.
183184
184185 | Code | Action |
185186 |---|---|
@@ -193,6 +194,7 @@ Successful commands are promoted near the top the next time the palette opens.
193194 | FPL / FPR / FPU / FPD | focus pane left / right / up / down |
194195 | NXT / PVT | switch to next / previous tab |
195196 | BSK | toggle the previously active session |
197+| JRS N | jump directly to recent session rank N |
196198 | SSP | open session picker |
197199 | VIS | enter visual mode |
198200 | FLT | show or hide the current tab's floating terminal |
@@ -108,6 +108,7 @@ code.focus-pane-down = FPD
108 code.next-tab = NXT108 code.next-tab = NXT
109 code.previous-tab = PVT109 code.previous-tab = PVT
110 code.back-session = BSK110 code.back-session = BSK
111+code.jump-recent-session = JRS
111 code.session-picker = SSP112 code.session-picker = SSP
112 code.visual-mode = VIS113 code.visual-mode = VIS
113 code.toggle-floating-pane = FLT114 code.toggle-floating-pane = FLT
@@ -179,7 +180,7 @@ Some terminals encode Alt+Space as a non-breaking space instead of `ESC Space`;
179 180
180 Open the palette with Alt+Space. Type a command code or fuzzy-match the label/description. Use Up/Down or Ctrl-N/Ctrl-P to move, Enter to run, and Esc/Ctrl-C to close.181 Open the palette with Alt+Space. Type a command code or fuzzy-match the label/description. Use Up/Down or Ctrl-N/Ctrl-P to move, Enter to run, and Esc/Ctrl-C to close.
181 182
182-Successful commands are promoted near the top the next time the palette opens.183+Successful commands are promoted near the top the next time the palette opens. `BSK` toggles only this client's previously active session. Type an exact `JRS` token to show the current interaction's immutable recent-session ranks; `JRS N` jumps to rank N. Invalid or stale ranks leave the palette open.
183 184
184 | Code | Action |185 | Code | Action |
185 |---|---|186 |---|---|
@@ -193,6 +194,7 @@ Successful commands are promoted near the top the next time the palette opens.
193 | FPL / FPR / FPU / FPD | focus pane left / right / up / down |194 | FPL / FPR / FPU / FPD | focus pane left / right / up / down |
194 | NXT / PVT | switch to next / previous tab |195 | NXT / PVT | switch to next / previous tab |
195 | BSK | toggle the previously active session |196 | BSK | toggle the previously active session |
197+| JRS N | jump directly to recent session rank N |
196 | SSP | open session picker |198 | SSP | open session picker |
197 | VIS | enter visual mode |199 | VIS | enter visual mode |
198 | FLT | show or hide the current tab's floating terminal |200 | FLT | show or hide the current tab's floating terminal |

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 2

Tags 13

↑↓ moveenter openesc close