Skip to content

Keybindings

The main keyboard reference for the terminal UI, grouped by screen.

The terminal UI is driven entirely from the keyboard. A few keys work everywhere, and each main screen adds its own. If you only want the basics, the terminal UI overview covers the handful you need to get moving.

Global keys

These work on every screen once you are past onboarding. During onboarding only q is live, so you can always back out.

KeyAction
qQuit
sOpen settings
?Open help
Ctrl+CQuit

s and ? are no-ops when you are already on that screen, so pressing s inside settings does nothing rather than stacking another screen.

While a review is streaming, q is taken over by the progress screen: it cancels the in-flight run instead of quitting. Press it again once the run has stopped to leave the app, or use Ctrl+C, which always quits.

Home menu

The home screen is a menu. You can move through it with the arrow keys and press Enter to pick an item, or jump straight to an item with its letter.

KeyAction
↑ / ↓Move through the menu
EnterOpen the highlighted item
rReview unstaged changes
RReview staged changes
lResume the last review
hHistory
sSettings
?Help
qQuit

Review

Inside a review the same letters do different work, because the screen owns the navigation. You move through the issue list with j and k, switch between the list and the details pane with Tab, and switch tabs inside the details pane with the left and right arrow keys.

KeyAction
jMove down the issue list
kMove up the issue list
TabSwitch pane
← / →Switch tab in the details pane
1 - 4Switch directly to the matching available details tab
cCancel the run, while a review is streaming
qCancel the run, while a review is streaming; quit otherwise
pOpen Providers with the failure's fix (Configure Provider, Change model, or Fix provider) when a review cannot start or fails on the provider
EscGo back

History

The history screen has search, date sections, saved runs, and an insights pane. Tab cycles the active zone, and each zone owns the keys below.

KeyAction
TabSwitch focus between search, dates, runs, and insights
↑ / ↓Select date sections immediately or navigate saved runs
EnterOpen the selected run or open the first Insights issue directly in review results
oOpen the selected run from the runs pane
/Focus search
Move from search to date sections
EscGo back; in search, clear the query, select the first visible run, and return focus to runs

Providers

The Providers screen splits focus between the provider list and the details pane. The details pane shows the highlighted provider's primary action, at most one secondary, and a More menu; the footer lists only the letter keys that provider can run right now.

KeyAction
↑ / ↓Move through the provider list
TabSwitch between the list and the action row
← / →Move between actions
EnterIn the list, run the highlighted provider's primary action (the footer names it); in the action row, activate the focused action; in More, run the highlighted entry (Delete configuration asks first)
mChange (or select) the model
eUpdate the configuration, or configure the provider
vVerify the configuration
dAsk to delete the configuration: a Delete configuration? confirm opens on Cancel; move to Delete and press Enter to delete, Esc keeps it
cReview the Provider data notice while it is not yet accepted (the details pane says so); Enter accepts, Esc declines
EscClose the More menu; otherwise go back

The first action that would send repository content — Configure or Update configuration (before the credentials overlay), Select configuration, Verify, or starting a review from Home — opens the same notice as a full-screen confirm when the consent is not on record: Enter is Accept and continue, Esc is Not now.

Settings

The settings hub is a menu, and the individual settings screens split focus between an options list and action buttons.

KeyAction
↑ / ↓Navigate the settings hub or the active options list
EnterOpen a hub item, select an option, or activate the focused action
SpaceSelect a theme or toggle a lens where that editor supports it
TabSwitch between options and action buttons
← / →Move between action buttons
EscGo back

Help screen

The help screen prints its own shortcut list and acts as the in-app cheat sheet. Press ? from anywhere to open it and Esc to leave.

KeyAction
↑ / ↓Navigate menus and lists
EnterSelect or confirm
EscGo back
TabSwitch pane
1 - 4Switch tab (in review)
j / kNavigate lists and the fix plan
↑ / ↓, PgUp / PgDn, Home / EndScroll content
m, e, v, d, cChange model, update configuration, verify, delete, review the provider data notice (on the Providers page)
sOpen settings
qQuit
?Open help
/Search runs (in history)
Info:

Note: The help screen does not list every home-menu shortcut. On the home screen, r and R start a review, l resumes the last review, and h opens history. The table above reflects the keys the help screen itself prints.

  • Terminal UI overview covers what the beta TUI is and how to start it.
  • Themes lists the palettes you can pass to --theme.
  • CLI reference documents every command-line option for the diffgazer binary.