Keyboard shortcuts
Move through a guided review without leaving the keyboard. Focus must not be in an editable field for most of these — when the comment composer is open, typing goes to the text field and only Esc / ⌘/Ctrl+Enter are intercepted.
The Guided Review sidebar always lists the same shortcuts as this page. 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 |
|---|---|
→ | Next Unit |
← | Previous 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 + 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.
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 split. In the extension, your choice is remembered in chrome.storage.local for the next review on this browser.
Diff search
Search every file path and line in the parsed diff — not only the active unit.
- Press
⌘/Ctrl+Fwhile the overlay is open. - 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. - Selecting a result jumps to the unit that owns that file (or hunk) and scrolls the match 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. Submit (⌘/Ctrl + Enter for a GitHub review) does not apply — use Generate Prompt from the UI instead (needs at least one note). Extra in the local UI:
| Shortcut | Action |
|---|---|
d | Open the Diff-Scope Dropdown |
⌘/Ctrl + I | Structure With AI |
⌘/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.