Keyboard shortcuts
Move through a guided review without leaving the keyboard. Most navigation keys need focus outside an editable field. In the comment composer, typing goes to the text field; actions, search, Esc, and ⌘/Ctrl+Enter still work.
Open Actions (⌘/Ctrl + K) and choose View keyboard shortcuts for the in-app reference. Most chords work in both the Chrome extension and the CLI; Local review adds CLI-only keys. Submit chords apply to the extension only.
Review navigation
| Shortcut | Action |
|---|---|
1 | Switch to Files |
2 | Switch to Review units |
⌘/Ctrl + I | Generate or retry the review plan; open provider setup if needed |
→ | Next File or Review Unit |
← | Previous File or Review Unit |
↑ / ↓ | Scroll the Code Pane |
Esc | Exit Guided Review (when not in comment mode or a modal) |
c | Enter Comment Mode (if the unit has selectable lines) |
⌘/Ctrl + K | Open Actions |
⌘/Ctrl + F | Open Diff Search |
⌘/Ctrl + Enter | Open Submit Review (or Connect GitHub if needed) |
On a GitHub PR, while Guided Review is open, keys are not passed through to GitHub’s page shortcuts. What a “unit” is: How a review plan works.
Switching tabs does not start generation. Press ⌘/Ctrl + I to generate review units when a plan is not yet complete. This shortcut stays inactive while generation is running or a text field has focus.
In the file list, ↑ / ↓ move focus, ← / → collapse or expand folders, and Home / End jump to the first or last visible row. Click a file or press Enter to open it and move focus to the diff. Comment and view shortcuts then work immediately. When a navigation tab has focus, ← / → switch tabs.
Actions
Press ⌘/Ctrl + K to open Actions. The header’s Search button opens the search step of the same palette; use its back arrow to return to actions. Type to find an action, move with ↑ / ↓, and select with Enter.
Open settings, view keyboard shortcuts, choose unified or split view, search files and code, or generate a prompt from your review notes. Generate prompt needs at least one note. GitHub reviews also offer Submit review.
Search and view mode open a second step in the same palette. Click the back arrow or press Backspace with an empty query to return to actions. Esc closes the palette and restores focus. Actions and search shortcuts also work from the comment composer; dialogs above the review keep their own keys.
Diff view
| Shortcut | Action |
|---|---|
v then u | Unified View |
v then s | Split View |
Type v, then u or s within about a second. You can also toggle unified / split from the toolbar while following the walkthrough.
Default is unified. A saved choice takes precedence. The extension remembers it in chrome.storage.local; the CLI remembers it in browser localStorage for the local URL.
Diff search
Search every file path and line in the parsed diff — not only the active unit.
- Press
⌘/Ctrl+Fwhile the overlay is open. This opens the action palette with Search files and code selected. - Type a path fragment or code snippet. Results are fuzzy-ranked (paths rank above line hits).
- Move with
↑/↓, open a hit withEnter, or close withEsc. - In Review units, selecting a result jumps to the unit that owns the match when one exists. In Files, or when no unit owns the match, it opens the file. The matching line scrolls into view.
Press ⌘/Ctrl + F again while the palette is open to re-focus and select the query. Renames match on the old or new path. Binary / elided files contribute path hits only.
This is Guided Review’s own search palette. On a PR page, GitHub’s find does not run while the overlay owns the keyboard.
Comment mode
| Shortcut | Action |
|---|---|
↑ / ↓ | Move the Line Cursor |
⇧ + ↑ / ↓ | Extend Multi-Line Selection |
Enter | Open the Comment Composer on the Selection |
⌘/Ctrl + Enter | Save Draft (composer open) |
Esc | Close Composer, or Exit Comment Mode |
← / → | Previous / Next Unit (still works in comment mode) |
Details and draft editing: Leave line comments. Drafts stay local until submit: Privacy & data.
Submit and modals
| Shortcut | Action |
|---|---|
Esc | Close the Topmost Modal (submit, connect GitHub, confirmation) without exiting the whole review when a modal owns focus |
↑ / ↓ / Enter | Choose Review Type on the Submit Dialog |
⌘/Ctrl + Enter | Submit from the Compose Step |
Enter / Esc | Dismiss the Post-Submit Success Dialog and Exit |
Full submit flow: Submit a review. Auth gate: Connect GitHub. If submit fails: Troubleshooting.
Local review
The CLI uses the same navigation, diff view, search, and comment-mode keys as the extension. Outside the composer, ⌘/Ctrl + Enter opens Generate Prompt when at least one note exists. Inside that dialog it copies the prompt; inside the composer it saves the draft. The CLI has no Exit button; Ctrl+C in the terminal stops the server. Extra in the local UI:
| Shortcut | Action |
|---|---|
d | Open the Diff-Scope Dropdown |
⌘/Ctrl + , | Settings |
Marketing site
On guidedreview.dev:
| Shortcut | Action |
|---|---|
⌘/Ctrl + I | Jump to the Install Section on the Homepage |
⌘/Ctrl + E | Open the Chrome Web Store Listing — also Chrome Extension |
⌘/Ctrl + C | Copy the CLI Install Command (npx @guided-review/cli) when the Install section is on the page |
⌘/Ctrl + G | Open the GitHub Repository |
Tip. Prefer keyboard navigation on large plans — it keeps attention on the unit narrative instead of hunting scroll position on the PR page.
