detached 72661bc

docs(config): simplify keybinding syntax examples

commit
72661bc3c4a9853c545199467318d8117feb289a
author
bnema · · 2026-01-11 14:21 UTC
committer
brice · · 2026-01-24 06:22 UTC
parent
e6c3832
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
1 file · +8 -8
M docs/CONFIG.md +8 -8
@@ -236,10 +236,10 @@ move-pane-to-tab = ["m"]
236236 move-pane-to-next-tab = ["M", "shift+m"]
237237
238238 # Consume-or-expel (niri-style) - very alpha
239-consume-or-expel-left = ["bracketleft", "["]
240-consume-or-expel-right = ["bracketright", "]"]
241-consume-or-expel-up = ["shift+bracketleft", "braceleft", "{"]
242-consume-or-expel-down = ["shift+bracketright", "braceright", "}"]
239+consume-or-expel-left = ["["]
240+consume-or-expel-right = ["]"]
241+consume-or-expel-up = ["{"]
242+consume-or-expel-down = ["}"]
243243
244244 focus-right = ["shift+arrowright", "shift+l"]
245245 focus-left = ["shift+arrowleft", "shift+h"]
@@ -312,10 +312,10 @@ Notes:
312312 | `workspace.shortcuts.close_pane` | string | `"ctrl+w"` | Close active pane (closes tab if last pane) |
313313 | `workspace.shortcuts.next_tab` | string | `"ctrl+tab"` | Next tab shortcut |
314314 | `workspace.shortcuts.previous_tab` | string | `"ctrl+shift+tab"` | Previous tab shortcut |
315-| `workspace.shortcuts.consume_or_expel_left` | string | `"alt+bracketleft"` | Consume into left sibling stack, or expel left if stacked (very alpha) |
316-| `workspace.shortcuts.consume_or_expel_right` | string | `"alt+bracketright"` | Consume into right sibling stack, or expel right if stacked (very alpha) |
317-| `workspace.shortcuts.consume_or_expel_up` | string | `"alt+shift+bracketleft"` | Consume into upper sibling stack, or expel up if stacked (very alpha) |
318-| `workspace.shortcuts.consume_or_expel_down` | string | `"alt+shift+bracketright"` | Consume into lower sibling stack, or expel down if stacked (very alpha) |
315+| `workspace.shortcuts.consume_or_expel_left` | string | `"alt+["` | Consume into left sibling stack, or expel left if stacked (very alpha) |
316+| `workspace.shortcuts.consume_or_expel_right` | string | `"alt+]"` | Consume into right sibling stack, or expel right if stacked (very alpha) |
317+| `workspace.shortcuts.consume_or_expel_up` | string | `"alt+{"` | Consume into upper sibling stack, or expel up if stacked (very alpha) |
318+| `workspace.shortcuts.consume_or_expel_down` | string | `"alt+}"` | Consume into lower sibling stack, or expel down if stacked (very alpha) |
319319
320320 > **Note:** New tab creation uses modal tab mode (Ctrl+T then n/c). This follows the Zellij-style modal keyboard interface.
321321 >
@@ -236,10 +236,10 @@ move-pane-to-tab = ["m"]
236 move-pane-to-next-tab = ["M", "shift+m"]236 move-pane-to-next-tab = ["M", "shift+m"]
237 237
238 # Consume-or-expel (niri-style) - very alpha238 # Consume-or-expel (niri-style) - very alpha
239-consume-or-expel-left = ["bracketleft", "["]239+consume-or-expel-left = ["["]
240-consume-or-expel-right = ["bracketright", "]"]240+consume-or-expel-right = ["]"]
241-consume-or-expel-up = ["shift+bracketleft", "braceleft", "{"]241+consume-or-expel-up = ["{"]
242-consume-or-expel-down = ["shift+bracketright", "braceright", "}"]242+consume-or-expel-down = ["}"]
243 243
244 focus-right = ["shift+arrowright", "shift+l"]244 focus-right = ["shift+arrowright", "shift+l"]
245 focus-left = ["shift+arrowleft", "shift+h"]245 focus-left = ["shift+arrowleft", "shift+h"]
@@ -312,10 +312,10 @@ Notes:
312 | `workspace.shortcuts.close_pane` | string | `"ctrl+w"` | Close active pane (closes tab if last pane) |312 | `workspace.shortcuts.close_pane` | string | `"ctrl+w"` | Close active pane (closes tab if last pane) |
313 | `workspace.shortcuts.next_tab` | string | `"ctrl+tab"` | Next tab shortcut |313 | `workspace.shortcuts.next_tab` | string | `"ctrl+tab"` | Next tab shortcut |
314 | `workspace.shortcuts.previous_tab` | string | `"ctrl+shift+tab"` | Previous tab shortcut |314 | `workspace.shortcuts.previous_tab` | string | `"ctrl+shift+tab"` | Previous tab shortcut |
315-| `workspace.shortcuts.consume_or_expel_left` | string | `"alt+bracketleft"` | Consume into left sibling stack, or expel left if stacked (very alpha) |315+| `workspace.shortcuts.consume_or_expel_left` | string | `"alt+["` | Consume into left sibling stack, or expel left if stacked (very alpha) |
316-| `workspace.shortcuts.consume_or_expel_right` | string | `"alt+bracketright"` | Consume into right sibling stack, or expel right if stacked (very alpha) |316+| `workspace.shortcuts.consume_or_expel_right` | string | `"alt+]"` | Consume into right sibling stack, or expel right if stacked (very alpha) |
317-| `workspace.shortcuts.consume_or_expel_up` | string | `"alt+shift+bracketleft"` | Consume into upper sibling stack, or expel up if stacked (very alpha) |317+| `workspace.shortcuts.consume_or_expel_up` | string | `"alt+{"` | Consume into upper sibling stack, or expel up if stacked (very alpha) |
318-| `workspace.shortcuts.consume_or_expel_down` | string | `"alt+shift+bracketright"` | Consume into lower sibling stack, or expel down if stacked (very alpha) |318+| `workspace.shortcuts.consume_or_expel_down` | string | `"alt+}"` | Consume into lower sibling stack, or expel down if stacked (very alpha) |
319 319
320 > **Note:** New tab creation uses modal tab mode (Ctrl+T then n/c). This follows the Zellij-style modal keyboard interface.320 > **Note:** New tab creation uses modal tab mode (Ctrl+T then n/c). This follows the Zellij-style modal keyboard interface.
321 >321 >

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 8

Tags 42

↑↓ moveenter openesc close