Skip to content
Guided Review
Documentation

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

ShortcutAction
1Switch to Files
2Switch to Review units
⌘/Ctrl + IGenerate or retry the review plan; open provider setup if needed
→Next File or Review Unit
←Previous File or Review Unit
↑ / ↓Scroll the Code Pane
EscExit Guided Review (when not in comment mode or a modal)
cEnter Comment Mode (if the unit has selectable lines)
⌘/Ctrl + KOpen Actions
⌘/Ctrl + FOpen Diff Search
⌘/Ctrl + EnterOpen 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

ShortcutAction
v then uUnified View
v then sSplit 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.

Search every file path and line in the parsed diff — not only the active unit.

  1. Press ⌘/Ctrl + F while the overlay is open. This opens the action palette with Search files and code selected.
  2. Type a path fragment or code snippet. Results are fuzzy-ranked (paths rank above line hits).
  3. Move with ↑ / ↓, open a hit with Enter, or close with Esc.
  4. 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.

Diff search for retryAfter showing highlighted code matches across the sample PR, with arrow-key navigation and Enter to open a result.

Comment mode

ShortcutAction
↑ / ↓Move the Line Cursor
⇧ + ↑ / ↓Extend Multi-Line Selection
EnterOpen the Comment Composer on the Selection
⌘/Ctrl + EnterSave Draft (composer open)
EscClose 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

ShortcutAction
EscClose the Topmost Modal (submit, connect GitHub, confirmation) without exiting the whole review when a modal owns focus
↑ / ↓ / EnterChoose Review Type on the Submit Dialog
⌘/Ctrl + EnterSubmit from the Compose Step
Enter / EscDismiss 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:

ShortcutAction
dOpen the Diff-Scope Dropdown
⌘/Ctrl + ,Settings

Marketing site

On guidedreview.dev:

ShortcutAction
⌘/Ctrl + IJump to the Install Section on the Homepage
⌘/Ctrl + EOpen the Chrome Web Store Listing — also Chrome Extension
⌘/Ctrl + CCopy the CLI Install Command (npx @guided-review/cli) when the Install section is on the page
⌘/Ctrl + GOpen the GitHub Repository
Note

Tip. Prefer keyboard navigation on large plans — it keeps attention on the unit narrative instead of hunting scroll position on the PR page.