Terminal UI
Keybinding Reference
The complete key map for the er terminal UI, grouped by task. Bottom-bar hints show a subset; this is
the full list. Hint groups are configurable — see Configuration. Press
? inside er for the built-in help hub, which always reflects the running version.
Navigation
| Key | Action |
| k / j | Next / previous file |
| n / N | Next / previous hunk |
| ↓ / ↑ | Next / previous line (within hunks) |
| Shift+↓ / Shift+↑ | Extend the line selection (the AI Hub's Copy context to clipboard copies the selected lines) |
| h / l or ← / → | Scroll left / right (long lines) |
| d / u (also Ctrl+d / Ctrl+u) | Scroll down / up 10 lines |
| PageDown / PageUp | Scroll down / up 20 lines |
| Home | Reset horizontal scroll |
| J / K | Previous / next inline item (questions, notes, GitHub comments — not findings) across files |
| Ctrl+j / Ctrl+k | Previous / next AI finding across files |
Diff modes
Number keys 1–9 switch between the visible mode tabs. Numbering is
dynamic: tabs are numbered in the order they appear, and modes that do not apply are hidden
without leaving gaps. On a typical local branch that means 1 Branch, 2 Unstaged,
3 Staged, 4 History — with extra tabs appearing when available: PR Diff (when the branch
has a known PR), Guided Tour (when a tour.json exists), Conflicts (during a merge), and
Hidden / watched files (when [watched] paths are configured). See
Diff Modes.
| Key | Action |
| 1–9 | Switch to the Nth visible mode tab |
| m | Toggle sort by recency (modification time) |
| R | Refresh the diff |
| w | Toggle watch mode |
| W | Toggle the watched-files section |
Review tracking
| Key | Action |
| Space | Toggle the current file as reviewed |
| ! | Filter the file list to unreviewed files |
| U | Jump to the next unreviewed file |
| / | Search files by name |
| f | Filter files (glob, status, size) |
| F | Filter presets & history |
Comments, questions & notes
Lowercase keys start a draft anchored to the current line (or to the hunk, when no line is selected). While composing, Ctrl+t
cycles the draft type — question → note → GitHub comment — and Tab pauses the draft (press
Tab again in normal mode to resume it). Uppercase keys toggle layer visibility, not
creation. See Comments & Questions.
| Key | Action |
| q | Start a private question on the current line (yellow) |
| c | Start a GitHub comment on the current line (cyan) — in Staged mode, c commits instead |
| Ctrl+t | While composing: cycle draft type (question → note → comment) |
| Q | Toggle visibility of the questions/notes layer |
| C | Toggle visibility of the GitHub-comments layer |
| A | Toggle visibility of the AI-findings layer |
| X | Hide / show resolved items |
| T | Cycle the confidence gate — every finding, then informational hidden, then confirmed only. Setting it by hand pins it; the default follows what the arbiter graded |
| J / K | Focus the previous / next inline item — questions, notes and GitHub comments, but never AI findings |
| r | Reply to the focused comment, question, or finding |
| e | Edit the focused comment (your own, top-level) — otherwise opens the file in $EDITOR |
| x | Delete the focused comment (with confirmation) |
Hubs
Most one-off actions live in small modal hubs rather than on dedicated keys. Each hub lists its own options
with single-key shortcuts.
| Key | Hub |
| a | AI Hub — Review work, Triage branch, Specialized review, Professor, Answer questions, summaries, cleanup (see AI Hub Actions) |
| g | Git hub — push to remote, stage files, refresh, pull / push GitHub comments, comment on or approve the PR |
| v | Verify hub — run tests, linter, type check, and other configured [commands] |
| y | Copy hub — copy the file, path, hunk, or line to the clipboard |
| o | Open hub — open another repo, switch worktree, review a remote PR, change the compare base |
| , | Settings hub — live-edit configuration (see Configuration) |
| ? | Help hub — the key reference, grouped by task |
GitHub sync requires gh
| Key | Action |
| G | Pull PR comments from GitHub |
| g → Push comments to GitHub | Push local comments — then r publishes them as one review, i as individual comments, n cancels |
| Ctrl+P | Git push the branch to the remote (Staged mode) |
Staging & committing
| Key | Action |
| s | Stage / unstage the current file (on a watched file: update its snapshot) |
| c | Commit (Staged mode only — elsewhere c starts a GitHub comment) |
| Ctrl+P | Push to the remote (Staged mode) |
Panels & layout
| Key | Action |
| p / P | Cycle the context panel forward / backward (file detail, AI summary, PR overview, agent log, off) |
| Tab | Toggle focus into the panel (or switch sides in split diff); with a paused draft, resumes it |
| Esc | Leave panel focus |
| < / > | Shrink / grow the file tree |
| { / } | Shrink / grow the side panel |
| + / = | Expand context lines for the current file |
| - | Collapse context lines |
| Enter | Expand a compacted file (or jump to the focused finding when the panel is focused) |
History & Tour modes
| Key | Action |
| k / j | Next / previous commit (History) or pillar (Tour) |
| n / N | Next / previous file within the commit or tour |
| Space | Toggle the current tour file as reviewed (Tour) |
| b | Mark every file in the current pillar reviewed (Tour) |
Tabs & repositories
| Key | Action |
| ] / [ | Next / previous tab |
| x | Close the current tab (when no comment is focused) |
| o | Open hub — another repo, worktrees, remote PRs, compare base |
Cleanup & general
| Key | Action |
| z | Clean up local draft questions & notes (with confirmation) |
| Z | Clean up AI reviews (with confirmation) |
| Esc | Clear search, then filter (innermost first) |
| Ctrl+q | Quit |
◆
Some keys are context-dependent: c comments everywhere except Staged mode, where it commits;
x deletes a focused comment but closes the tab when nothing is focused; e edits a focused
comment of your own but otherwise opens the file in your editor. The bottom bar and the ? help hub
always reflect what is available right now.