Keyboard and mouse
Press ? at any time for Hunk's in-app shortcut reference. Menus and primary review actions are also mouse-selectable.
Navigate the review
Section titled “Navigate the review”| Keys | Action |
|---|---|
↑ / ↓, k / j | Scroll one row |
Space / f, b | Page down / up |
Shift+Space | Page up |
d / u | Half page down / up |
[ / ] | Previous / next hunk |
, / . | Previous / next file |
{ / } | Previous / next annotated hunk |
/ | Search diff content |
n / N | Next / previous search match |
Home / End, g / G | Start / end of review |
← / → | Scroll unwrapped code; hold Shift for faster movement |
Hunk navigation stays review-wide: hunk and file shortcuts move through the same multi-file stream shown in the main pane.
/ opens a less-style prompt on the status row. Enter jumps to the next hunk containing the text (case-insensitive until the query has an uppercase letter), n / N repeat in either direction and wrap, the status row reports [i/n] path:line, and every match is marked inside the diff with the landed line inverted. Reopening / shows the last query: Escape clears it, and submitting the emptied prompt ends the search.
↑ / ↓ and k / j move a highlighted current line, and the view scrolls only far enough to keep it visible. Paging or scrolling past it moves it to the nearest line still on screen, and c anchors a note on it. Pick the marker from the View menu, or set cursor_line: number marks only the line number, and off turns the marker off and lets ↑ / ↓ and k / j scroll the view one row at a time instead.
Change the view
Section titled “Change the view”| Key | Action |
|---|---|
0 / 1 / 2 | Auto / unified / split layout |
s | Toggle files pane |
t | Choose a theme |
l | Toggle line numbers |
w | Toggle line wrapping |
m | Toggle hunk metadata |
M | Toggle menu bar |
z | Toggle unchanged context for the selected hunk |
a | Toggle agent notes |
e | Open the selected file in $EDITOR |
Tab | Move focus between the file list and file filter |
r | Reload a reloadable input |
F10 | Open menus |
q | Quit |
Hunk may offer to save view changes on quit. Saving writes personal preferences globally unless the repository already has a .hunk/config.toml.
Add a human note
Section titled “Add a human note”Press c on the selected hunk or use a visible add-note affordance with the mouse. While editing, app shortcuts are suspended so normal text entry works. Save with the note editor's displayed action or cancel with Escape.
Mouse behavior
Section titled “Mouse behavior”- Click a sidebar file to jump to it in the review stream.
- Click menus and dialog actions instead of their key equivalents.
- Use the wheel or scrollbar to move through the review; hold Shift while scrolling to move horizontally through unwrapped code.
- Select diff text for copy where the terminal supports it.
Remap the defaults
Section titled “Remap the defaults”Every shortcut above is a named command you can move to different keys with a [keybindings] table in your user config. See Keybindings. The file filter ships without its own key (Tab and the File menu reach it); "hunk.review.focusFilter" = "/" puts it back on / and hands search the remaining keys.
Terminal mouse protocols vary; see terminal compatibility if clicks or selection do not behave as expected.