Keyboard shortcuts
The review UI is keyboard-first. Press ? in the review for this sheet.
Move
| Key | Action |
|---|---|
j / k | Next / previous hunk |
J / K | Next / previous file |
n | Next unreviewed file, rolling into the next layer when the current one is read |
] / [ | Next / previous layer (when the agent has posted layers) |
. | Next decision in this layer: opens its card and lands on the first place it names (see Decisions) |
/ | Filter files |
Read
| Key | Action |
|---|---|
v | Mark this file reviewed |
h | Hide reviewed files |
u | Unified / split |
o | Collapse / expand file |
b | Show / hide the file list |
Comment
| Key | Action |
|---|---|
c | Comment on the clicked line, or on this hunk when no line is clicked |
⌘↵ | Add the comment |
⌘. | On a pull request, flip the composer between Comment on PR and Ask agent |
esc | Close / cancel |
? | This sheet |
With layers, J / K stay inside the active layer and ] / [ step between layers, skipping any layer the filters have emptied. n walks the whole plan: once the active layer is read it moves on to the first unread file in the next.
v marks a whole file, not the hunk under the cursor, which is worth knowing because coverage is reported per hunk. Reading every hunk in a file and pressing v are two different claims, and Finish review sends both.
⌘↵ adds the comment and leaves it in your review; it does not send it to the agent. Sending is Send to agent on a single thread, or Finish review for the batch. On a pull request ⌘. picks the side first: a comment for GitHub, or a private question for the agent (see Two kinds of comment).
Multi-line comments are mouse grammar rather than keys: drag down the line numbers to select a range, shift-click a line number to move the open composer's free edge there, and the ▲/▼ on the composer's chip walk that edge one line at a time, through the starting line and out the other side, so a run of ▼ reads "this line as top, N lines down". Every press is reversible.