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

KeyAction
k / jNext / previous file
n / NNext / 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 / PageUpScroll down / up 20 lines
HomeReset horizontal scroll
J / KPrevious / next inline item (questions, notes, GitHub comments — not findings) across files
Ctrl+j / Ctrl+kPrevious / 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.

KeyAction
1–9Switch to the Nth visible mode tab
mToggle sort by recency (modification time)
RRefresh the diff
wToggle watch mode
WToggle the watched-files section

Review tracking

KeyAction
SpaceToggle the current file as reviewed
!Filter the file list to unreviewed files
UJump to the next unreviewed file
/Search files by name
fFilter files (glob, status, size)
FFilter 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.

KeyAction
qStart a private question on the current line (yellow)
cStart a GitHub comment on the current line (cyan) — in Staged mode, c commits instead
Ctrl+tWhile composing: cycle draft type (question → note → comment)
QToggle visibility of the questions/notes layer
CToggle visibility of the GitHub-comments layer
AToggle visibility of the AI-findings layer
XHide / show resolved items
TCycle 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 / KFocus the previous / next inline item — questions, notes and GitHub comments, but never AI findings
rReply to the focused comment, question, or finding
eEdit the focused comment (your own, top-level) — otherwise opens the file in $EDITOR
xDelete 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.

KeyHub
aAI Hub — Review work, Triage branch, Specialized review, Professor, Answer questions, summaries, cleanup (see AI Hub Actions)
gGit hub — push to remote, stage files, refresh, pull / push GitHub comments, comment on or approve the PR
vVerify hub — run tests, linter, type check, and other configured [commands]
yCopy hub — copy the file, path, hunk, or line to the clipboard
oOpen 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

KeyAction
GPull PR comments from GitHub
g → Push comments to GitHubPush local comments — then r publishes them as one review, i as individual comments, n cancels
Ctrl+PGit push the branch to the remote (Staged mode)

Staging & committing

KeyAction
sStage / unstage the current file (on a watched file: update its snapshot)
cCommit (Staged mode only — elsewhere c starts a GitHub comment)
Ctrl+PPush to the remote (Staged mode)

Panels & layout

KeyAction
p / PCycle the context panel forward / backward (file detail, AI summary, PR overview, agent log, off)
TabToggle focus into the panel (or switch sides in split diff); with a paused draft, resumes it
EscLeave panel focus
< / >Shrink / grow the file tree
{ / }Shrink / grow the side panel
+ / =Expand context lines for the current file
-Collapse context lines
EnterExpand a compacted file (or jump to the focused finding when the panel is focused)

History & Tour modes

KeyAction
k / jNext / previous commit (History) or pillar (Tour)
n / NNext / previous file within the commit or tour
SpaceToggle the current tour file as reviewed (Tour)
bMark every file in the current pillar reviewed (Tour)

Tabs & repositories

KeyAction
] / [Next / previous tab
xClose the current tab (when no comment is focused)
oOpen hub — another repo, worktrees, remote PRs, compare base

Cleanup & general

KeyAction
zClean up local draft questions & notes (with confirmation)
ZClean up AI reviews (with confirmation)
EscClear search, then filter (innermost first)
Ctrl+qQuit
◆

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.