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.
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.
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.
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.
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.
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.
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.
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.
Related
- 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
diffgazerbinary.