22. Keyboard & input#
The prompt is a small editor. This page is the key map; the behaviour behind some keys lives in other pages.
/help inside a session shows the same map, filtered to the keys that actually
work in your terminal. /config edit opens ~/.rayu/config.toml in $EDITOR if
you want to remap a key.
Sending#
| Key | Action |
|---|---|
Enter | Send the prompt |
Shift+Enter | Insert a newline (needs a terminal that reports modified keys, or /terminal-setup) |
Option+Enter / Alt+Enter | Insert a newline |
\ then Enter | Insert a newline; works in every terminal |
Ctrl+Enter / Cmd+Enter | Send with the opposite mode while a turn is running |
Ctrl+Tab / Ctrl+T | Toggle queue mode: the next prompt waits instead of interrupting |
Ctrl+Up | Pull a queued message back for editing |
If Shift+Enter sends instead of breaking the line, run /terminal-setup once.
Until then use the trailing-backslash form.
Stopping and clearing#
| Key | Action |
|---|---|
Esc | Stop the running turn; the partial answer stays |
Esc on an empty prompt | Open the message selector (/rewind) |
Ctrl+C | Clear a non-empty prompt |
Ctrl+C twice | Exit rayu |
Ctrl+D twice | Exit from an empty prompt |
Ctrl+L | Clear the screen; history stays in scrollback |
Ctrl+U | Clear the input line |
Ctrl+K | Delete from the cursor to the end of the input |
Editing#
| Key | Action |
|---|---|
Ctrl+A | Copy the visible viewport plus nearby context |
Ctrl+X | Cut the whole input line to the clipboard |
Ctrl+V | Paste text or an image from the clipboard |
Ctrl+Z / Cmd+Z | Undo the last input edit |
Ctrl+W, Alt+Backspace | Delete the previous word |
Ctrl+B / Ctrl+F | Move by word |
Ctrl+Left / Ctrl+Right | Move by word |
Home / End | Move to start / end of the input |
Ctrl+S | Stash the input; press again to pop it back |
Ctrl+R | Fuzzy reverse search over prompt history |
Tab | Autocomplete the current token |
Scrolling and navigation#
| Key | Action |
|---|---|
Up / Down | Scroll history when the input is empty |
PageUp / PageDown | Page the transcript |
Ctrl+J / Ctrl+K | Jump to the next / previous prompt |
Alt+U / Alt+D | Page up / down |
Ctrl+G | Bookmark a scroll position |
Ctrl+P | Toggle typing scroll lock |
Alt+X | Show or dismiss the todo card |
Alt+I | Toggle the info widget |
Alt+J / Alt+K | Move between workspace panes |
The default bindings live in [keybindings] in ~/.rayu/config.toml, and each
one has an environment override (RAYU_SCROLL_UP_KEY, RAYU_SIDE_PANEL_TOGGLE_KEY,
…). /keys reports bindings that your terminal or OS swallows, and
/hotkeys lists them with your own usage counts.
Models, effort and modes#
| Key | Action |
|---|---|
Shift+Tab | Cycle favorite models |
Ctrl+N | Toggle a favorite (inside the model picker) |
Ctrl+O | Set the session default model (inside the picker) |
Alt+Left / Alt+Right | Decrease / increase reasoning effort |
Alt+Up / Alt+Down | Faster / slower speed tier where supported |
Alt+Shift+M | Show or hide the diagram pane |
Alt+M | Cycle the side panel: split, fullscreen, hidden |
Alt+Y | Toggle selection/copy mode |
Alt+C | Toggle centered layout |
Shift+Tab is model favorites, not permission modes. v3 asks for no tool
permissions during a normal turn; see
Permissions & safety.
Side panel, diagrams and diffs#
| Key | Action |
|---|---|
Ctrl+1..Ctrl+4 | Resize the side panel to 25/50/75/100% |
Ctrl+H / Ctrl+L | Focus chat / diagram / diffs |
Ctrl+Left / Ctrl+Right | Cycle diagrams when the diagram pane is focused |
h j k l or arrows | Pan a focused diagram |
[ / ] | Zoom a diagram |
+ / - | Resize the diagram pane |
Alt+G | Show the project's git commit log |
Images and voice#
Paste an image with Ctrl+V; it attaches to the next prompt and the model sees
it if it is vision-capable. Alt+Shift+I shows or hides inline images.
Ctrl+Space starts voice input when a voice backend is configured (/voice).
/dictate runs the external dictation command from [dictation]; the global
key for that is whatever you set in [dictation] key.
Terminals#
Rayu renders best in a truecolor terminal with the Kitty keyboard protocol:
Ghostty, Kitty, WezTerm, iTerm2, Alacritty, and recent Windows Terminal. Inside
tmux, set default-terminal "tmux-256color" and enable RGB or the theme will
look wrong and rows may drift.
Next: Permissions & safety →