Skip to content
Empryo

Keyboard shortcuts

Every keyboard shortcut in the Empryo desktop app and terminal UI, and how to rebind desktop shortcuts with the keybindings setting.

Reference14 minutes to read
Copy & share
On this page12 sections

Every shortcut in both apps, on one page. In the desktop app Cmd is the macOS key and Ctrl the Windows and Linux one, written Cmd/Ctrl. Press ? in the desktop app or Alt+H in the terminal app to see the list inside the app.

Desktop appLink to this section

Rebind a shortcutLink to this section

Add keybindings to your configuration: action name → key. Only the actions you list change.

json
{ "keybindings": { "tab-search": "mod+o", "palette": "mod+p", "graph": "none" } }
  • mod is Cmd on macOS and Ctrl elsewhere. Other modifiers: ctrl, cmd (or meta), alt (or option), shift.
  • The key is a letter, a digit, f1–f24, left, right, up, down, tab, space, enter, escape, backspace, delete, home, end, pageup, pagedown, or a punctuation key. Names such as comma, period, slash, backslash, backquote, minus, equal, plus, pgup and pgdn work too.
  • A shortcut needs mod, ctrl or cmd, or is an f-key (f6). A bare key such as space, or shift+a and alt+a, is ignored so you can still type it.
  • "none" turns a shortcut off.
  • Cmd/Ctrl with =, +, - or 0 is the window zoom, and F11 is full screen on Windows and Linux. Binding an action to one of them is ignored.
  • An unknown action, a key Empryo cannot read, or a value that is not text is ignored, and that shortcut keeps its default. The rest of the config still loads.
  • A key you bind wins over another action's default.
  • Changes apply as soon as the config is saved. The app menu, tooltips and the ? cheatsheet show the new keys.
  • A letter follows the letter your keyboard layout types, so mod+z is the key marked Z on QWERTZ and AZERTY too. Digits and keyboards that do not type Latin letters use the key's position.
  • On Windows and Linux, typing with AltGr (for @, € or [) never fires a shortcut. On Windows, Ctrl+Alt and AltGr are the same key to the system on layouts that have AltGr, so a ctrl+alt shortcut may not fire there; mod+shift is the safer choice. Inside a web page in the browser panel on Windows, a ctrl+alt shortcut follows the typed character only.
  • While a panel below has focus, its own keys come first. find also opens search in an open file.
  • The mic shortcut is set apart, with `voice.key`.

Ask Empryo (“open the tab search with Cmd+O”) and it sets this through the settings tool, which refuses unknown actions, keys it cannot read and bare typing keys.

Rebindable shortcutsLink to this section

ActionDefaultWhat it does
paletteCmd/Ctrl+KCommand palette
tab-searchCmd/Ctrl+Shift+ASearch open tabs
settingsCmd/Ctrl+,Settings
stop-turnCmd/Ctrl+.Stop the running turn
focus-composerCmd/Ctrl+LFocus the prompt box, also from the browser panel
sidebarCmd/Ctrl+BShow or hide the sidebar
side-panelCmd/Ctrl+JShow or hide the side panel
tools-paneCmd/Ctrl+IOpen tools and diffs
graphCmd/Ctrl+Shift+GOrchestration graph or chat
stem-panelCmd/Ctrl+Shift+LStem panel, when Stem is on
findCmd/Ctrl+FSearch the conversation or the open file
searchCmd/Ctrl+Shift+FSearch the whole project
splitCmd/Ctrl+\Split the view
split-orientationCmd/Ctrl+Shift+\Switch between side by side and stacked
previous-pane / next-paneCmd/Ctrl+Alt+← / →Move between split panes
new-tabCmd/Ctrl+TNew tab
close-tabCmd/Ctrl+WClose the tab
reopen-tabCmd/Ctrl+Shift+TReopen the last closed tab
next-tab / previous-tabCtrl+Tab / Ctrl+Shift+TabNext / previous tab
tab-1 … tab-9Cmd/Ctrl+1 … 9Go to tab 1–9
terminal` Ctrl+ ``Show or hide the terminal
browserCmd/Ctrl+Shift+BShow or hide the browser
expand-toolsCmd/Ctrl+Shift+EExpand or collapse every tool call

Fixed shortcutsLink to this section

ShortcutWhat it does
EnterSend. While a turn runs, it steers the turn (see appearance.enterQueues).
Shift+EnterNew line
Cmd/Ctrl+EnterQueue a follow-up while a turn runs (steers when appearance.enterQueues is on)
Shift+TabStep to the next mode, in the prompt box
Cmd/Ctrl+Shift+MChoose the model for this tab
⌘⌥E (macOS), Alt+E (Windows, Linux)Step reasoning effort
↑ / ↓Previous / next prompt from history
Ctrl+RFuzzy-search prompt history
Cmd/Ctrl+SStash the draft
Cmd/Ctrl+Shift+SOpen the stashed drafts
Cmd/Ctrl+VPaste an image into the prompt box
@Mention a file
EscStop the running turn when the prompt box is empty; close an overlay or preview
?Shortcut cheatsheet
Cmd/Ctrl+Shift+NNew window
Cmd/Ctrl+Shift+WClose the window
Cmd/Ctrl+= / - / 0Zoom in, out, actual size
F11 (Windows, Linux)Full screen
Cmd+Y (macOS), Ctrl+Y (Windows, Linux)Start or stop voice input. Change it with voice.key. Esc cancels a recording.

Prompt box listsLink to this section

ShortcutWhat it does
/ at the startStart a slash command; a list of commands opens
@Mention a file; a list of files opens
$Add skills to this message; a list of skills opens
↑ / ↓Move through the open list
EnterPick the highlighted command or file
TabPick the highlighted file, or complete the highlighted command
Space in the skill listChoose or unchoose the highlighted skill
Enter / Tab in the skill listAdd the chosen skills
Esc, or Backspace with nothing typed after $Close the skill list
EscClose the file list; in the command list, clear the prompt box
Ctrl+RSearch prompt history; Esc or Ctrl+R again closes it

Prompt box editingLink to this section

While the prompt box has focus, Ctrl (not Cmd) edits text like a shell:

ShortcutWhat it does
Ctrl+UDelete the current line
Ctrl+CClear the draft when nothing is selected
Ctrl+K (macOS)Delete to the end of the line
Ctrl+W (macOS)Delete the word before the cursor

Inside panelsLink to this section

These work while the panel or card has focus, and come before the shortcuts above. Morphs can add their own key chords.

PanelShortcutWhat it does
Open fileCmd/Ctrl+SSave
Open fileCmd/Ctrl+F (the find key)Find in the file
Open fileEscClose the find bar
File tree filter↓Move from the filter into the file list
Projects filter↓, Enter, EscMove into the list, open the first matching project, clear the filter
Panel divider← / →, Home / End, Enter / SpaceMake the panel narrower or wider (Shift for bigger steps), smallest or largest, back to its usual width
File tree, Projects↑ / ↓, Home / EndMove between rows
File tree, Projects→ / ←Open or close a folder; ← also moves to the parent
File treeEnter / SpaceOpen a file, or open and close a folder
File treeF2Rename
File treeDelete, or Cmd/Ctrl+BackspaceDelete
File treeCmd/Ctrl+C / X / VCopy, cut, paste a file
BrowserCmd/Ctrl+TNew browser tab
BrowserCmd/Ctrl+WClose the browser tab
BrowserCmd/Ctrl+LFocus the address bar
BrowserCmd/Ctrl+RReload
BrowserCmd/Ctrl+Shift+[ / ]Previous / next browser tab
BrowserCmd/Ctrl+1 … 8, Cmd/Ctrl+9Browser tab 1–8, last browser tab
Browser pageCmd/Ctrl+EscLeave the page and go back to Empryo
Browser pageCmd/Ctrl+= / - / 0Zoom the page
TerminalCmd+C (macOS), Ctrl+Shift+C, or Ctrl+C / Ctrl+Insert with a selection (Windows, Linux)Copy
TerminalCtrl+Shift+V or Shift+Insert (Windows, Linux)Paste
TerminalCmd/Ctrl+FFind in the terminal
Terminal find barEnter / Shift+Enter, EscNext / previous match, close the find bar
TerminalCmd/Ctrl+Shift+A with a selectionAdd the selection to your message
Orchestration graphEscClear the selection, leave focus, then close the graph
Orchestration graphEnterSelect the overlord, or steer the selected agent
Orchestration graphFFit the graph to the view
Orchestration graphArrow keysMove between agents
Orchestration graphBackspace / DeleteCut the selected agent
Orchestration graph+ / -Zoom in, out. Cmd/Ctrl+0 resets the window zoom, not the graph's.
GitCmd/Ctrl+Enter in the commit messageCommit
Git↑ / ↓, Home / End in the changed filesMove between files
Model picker↑ / ↓, Home / End, EnterMove through models, pick one
Model picker← / → with an empty searchPrevious / next provider
Sessions menu↑ / ↓, EnterMove through sessions, open one
Update dialog↑ / ↓, Home / End on the notes gripMake the release notes shorter or taller, smallest or largest; Shift takes bigger steps
Sign-in accounts↑ / ↓, Home / End; ↓ from its searchMove between accounts, go from the search into the list
Engine list↑ / ↓, Home / End, Page Up / Page DownMove between engines, ten at a time with Page Up / Page Down
Command palette↑ / ↓, EnterMove through results, run one
Command paletteTab / Shift+TabNext / previous scope
Command palette> or /, # firstSearch only commands, only memories
Tab bar← / →, Home / EndMove to another tab
Tab barEnter / Space, DeleteOpen the focused tab, close it
Tab search↑ / ↓, EnterChoose a tab, switch to it
Tab searchEscClear the search, then close it
ProjectsNNew tab in the focused project
ProjectsDelete / BackspaceRemove or hide the focused project
Question card↑ / ↓, EnterChoose an answer and send it; on Other, start typing
Question card1 … 9Send that answer
Question cardEscSkip the question, when it can be skipped; while typing, go back to the choices
DiffEnter / Shift+Enter in its searchNext / previous match
Diff↑ / ↓, Shift+↑ / Shift+↓Move the line cursor, extend the selection
Diff file list↓ / j, ↑ / k, Home / EndMove between files
Diff file listOOpen the file
Find in a fileEnter / Shift+EnterNext / previous match
Find in the conversationEnter / Shift+Enter, EscNext / previous match, close the find bar
Image viewer+ / =, -, 0Zoom in, out, reset
Image editorDelete / BackspaceRemove the selected shape
Image editorEnter in a text labelPlace the text
CanvasEscBack to the chat
Canvas cardEnter, [ / ], ROpen it, move it back / forward, run it
Genome map/Search files
Genome mapF, + / =, -Fit, zoom in, zoom out
Genome mapArrow keysPan
Genome mapEscStep back: stop the trace, leave solo, leave the room, clear the selection
Genome map searchEnter, EscPick the first match, clear the search
Pull requests↑ / ↓, Home / EndMove between pull requests
Pull requestsO, R, C, DOpen, refresh, copy the link, view the diff
Pull requestsDelete / Backspace, Shift+F10Remove from the list, open its menu
Steering log↓ from its search, ↑ / ↓, EscInto the list, move, clear the search
Start screen↑ / ↓, EnterChoose a session or profile, continue
Start screenEscBack from the profile step
Settings↑ / ↓, Enter, Esc in its searchMove through results, open one, clear the search
Settings↑ / ↓, Home / End in the section listMove between sections
PlanCmd/Ctrl+Enter in a commentSend the comment
FeedbackCmd/Ctrl+EnterSend the feedback
Guided tour← / →Previous / next step
LogsEnter / Space, EscOpen a row, clear the filter
Prompt queueEsc in its searchClear the search
Rename fieldsEnter, EscSave, cancel

Terminal appLink to this section

The terminal app's shortcuts are fixed, except the mic key: Ctrl+Y starts and stops voice input, and `voice.key` changes it (Esc cancels a recording). While a panel or dialog is open, it handles its own keys.

Session and menusLink to this section

KeysWhat it does
Ctrl+KCommand palette
Alt+HKeyboard reference
Ctrl+LPick a provider and model
Ctrl+DCycle to the next mode
Alt+EStep reasoning effort for this tab
Ctrl+NNew session. The current one is saved first.
Ctrl+SBrowse and install skills
Ctrl+GGit menu
Ctrl+PBrowse and restore past sessions
Alt+PProjects
Alt+RError log
Ctrl+EShow or hide the Neovim editor
Ctrl+XStop the current response
Ctrl+CCopy the selection. With nothing selected it clears the prompt box; in an empty prompt box it quits.
Ctrl+Shift+CCopy the selection. Never quits.
Cmd+CCopy the selection, in terminals that pass Cmd through
EscClear the selection
Ctrl+Shift+EscStop all computer use and release the mouse and keyboard

TabsLink to this section

KeysWhat it does
Ctrl+TNew tab
Ctrl+Shift+TReopen the last closed tab
Ctrl+WClose the tab
Ctrl+1 … Ctrl+9, Ctrl+0Go to tab 1–9, or tab 10. Alt+1 … Alt+0 work too.
Ctrl+\ / Ctrl+]Previous / next tab
TabNext tab, in the prompt box when no autocomplete list is open

ChatLink to this section

KeysWhat it does
Ctrl+OExpand or collapse all code and reasoning blocks
Ctrl+B / Ctrl+FBack / forward through checkpoints, then live
Alt+K / Alt+JScroll the chat up / down
Page Up / Page DownScroll a screen at a time

Prompt boxLink to this section

KeysWhat it does
EnterSend. While the agent works, it steers the current turn.
Shift+Enter / Ctrl+JNew line
Ctrl+UDelete the current line
→Accept the suggested completion
EscClose the suggestion list or history search, cancel a recording, or leave a checkpoint you are viewing
Alt+QQueue as a follow-up turn. Alt+Enter or Ctrl+Enter too, where the terminal passes them through.
Alt+OOpen a folded paste
Alt+S / Alt+PStash the draft / bring back the last stash
↑ / ↓Previous / next prompt from history
Ctrl+RFuzzy-search prompt history
Shift+TabCycle to the previous mode
Ctrl+V / Alt+VPaste an image
@Mention a file
$Add skills to this message: ↑ / ↓ to move, Space to choose, Enter to add, Esc to close
/Start a slash command