detached fd78dcb

docs: update prompt history keybinding docs

commit
fd78dcb05341eef6002bf0a03a8e5f1f64fd34d1
author
patriceckhart · · 2026-07-02 05:10 UTC
parent
2881f0d
signature
unsigned
3 files · +5 -6
M README.md +2 -2
@@ -657,14 +657,14 @@ Type `@` followed by a filter string to narrow the list (e.g. `@read` shows only
657657 | `alt+left`, `alt+right` | Jump one word back or forward. |
658658 | `ctrl+u`, `ctrl+k` | Delete to start or end of line. |
659659 | `ctrl+w`, `alt+backspace` | Delete the previous word. |
660-| `up`, `down` (editor non-empty) | Cycle through prompt history. |
660+| `up`, `down` | Move within multi-line input. At the top edge, `up` recalls previous prompts and `down` moves forward through prompt history. |
661661
662662 ### Chat scroll
663663
664664 | Key | Action |
665665 |---|---|
666666 | `pgup`, `pgdn` | Scroll one page up or down. |
667-| `up`, `down` (editor empty) | Scroll three lines up or down. This is how the mouse wheel reaches the scroll logic on most terminals. |
667+| `up`, `down` (editor empty, not browsing prompt history) | Scroll three lines up or down. This is how the mouse wheel reaches the scroll logic on most terminals. |
668668
669669 ## Extensions
670670
@@ -657,14 +657,14 @@ Type `@` followed by a filter string to narrow the list (e.g. `@read` shows only
657 | `alt+left`, `alt+right` | Jump one word back or forward. |657 | `alt+left`, `alt+right` | Jump one word back or forward. |
658 | `ctrl+u`, `ctrl+k` | Delete to start or end of line. |658 | `ctrl+u`, `ctrl+k` | Delete to start or end of line. |
659 | `ctrl+w`, `alt+backspace` | Delete the previous word. |659 | `ctrl+w`, `alt+backspace` | Delete the previous word. |
660-| `up`, `down` (editor non-empty) | Cycle through prompt history. |660+| `up`, `down` | Move within multi-line input. At the top edge, `up` recalls previous prompts and `down` moves forward through prompt history. |
661 661
662 ### Chat scroll662 ### Chat scroll
663 663
664 | Key | Action |664 | Key | Action |
665 |---|---|665 |---|---|
666 | `pgup`, `pgdn` | Scroll one page up or down. |666 | `pgup`, `pgdn` | Scroll one page up or down. |
667-| `up`, `down` (editor empty) | Scroll three lines up or down. This is how the mouse wheel reaches the scroll logic on most terminals. |667+| `up`, `down` (editor empty, not browsing prompt history) | Scroll three lines up or down. This is how the mouse wheel reaches the scroll logic on most terminals. |
668 668
669 ## Extensions669 ## Extensions
670 670
M packages/agent/modes/help.go +1 -1
@@ -23,7 +23,7 @@ var helpKeyRows = [][2]string{
2323 {"ctrl+l", "redraw the screen"},
2424 {"ctrl+o", "expand / collapse long tool results"},
2525 {"pgup / pgdn", "scroll the chat one page up / down"},
26- {"up / down", "move within multi-line input - scroll chat at input edge"},
26+ {"up / down", "move in input, browse prompt history at top edge, scroll chat when empty"},
2727 }
2828
2929 // renderHelpBlock builds the friendly /help view. Uses the shared
@@ -23,7 +23,7 @@ var helpKeyRows = [][2]string{
23 {"ctrl+l", "redraw the screen"},23 {"ctrl+l", "redraw the screen"},
24 {"ctrl+o", "expand / collapse long tool results"},24 {"ctrl+o", "expand / collapse long tool results"},
25 {"pgup / pgdn", "scroll the chat one page up / down"},25 {"pgup / pgdn", "scroll the chat one page up / down"},
26- {"up / down", "move within multi-line input - scroll chat at input edge"},26+ {"up / down", "move in input, browse prompt history at top edge, scroll chat when empty"},
27 }27 }
28 28
29 // renderHelpBlock builds the friendly /help view. Uses the shared29 // renderHelpBlock builds the friendly /help view. Uses the shared
M packages/agent/modes/interactive.go +2 -3
@@ -429,9 +429,8 @@ type Interactive struct {
429429 parkedTotal int
430430
431431 // inputHistoryIndex is -1 when not browsing history. When the
432- // editor is empty, Left/Right can walk previous user prompts for
433- // quick manual testing without stealing normal cursor movement in
434- // non-empty input.
432+ // editor is empty, Up/Down can walk previous user prompts without
433+ // stealing normal vertical cursor movement in non-empty input.
435434 inputHistoryIndex int
436435
437436 // lastCtrlC is when the user last pressed ctrl+c. The first press
@@ -429,9 +429,8 @@ type Interactive struct {
429 parkedTotal int429 parkedTotal int
430 430
431 // inputHistoryIndex is -1 when not browsing history. When the431 // inputHistoryIndex is -1 when not browsing history. When the
432- // editor is empty, Left/Right can walk previous user prompts for432+ // editor is empty, Up/Down can walk previous user prompts without
433- // quick manual testing without stealing normal cursor movement in433+ // stealing normal vertical cursor movement in non-empty input.
434- // non-empty input.
435 inputHistoryIndex int434 inputHistoryIndex int
436 435
437 // lastCtrlC is when the user last pressed ctrl+c. The first press436 // lastCtrlC is when the user last pressed ctrl+c. The first press

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 1

Tags 476

↑↓ moveenter openesc close