Keyboard & input
Guides

Keyboard & input

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#

KeyAction
EnterSend the prompt
Shift+EnterInsert a newline (needs a terminal that reports modified keys, or /terminal-setup)
Option+Enter / Alt+EnterInsert a newline
\ then EnterInsert a newline; works in every terminal
Ctrl+Enter / Cmd+EnterSend with the opposite mode while a turn is running
Ctrl+Tab / Ctrl+TToggle queue mode: the next prompt waits instead of interrupting
Ctrl+UpPull 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#

KeyAction
EscStop the running turn; the partial answer stays
Esc on an empty promptOpen the message selector (/rewind)
Ctrl+CClear a non-empty prompt
Ctrl+C twiceExit rayu
Ctrl+D twiceExit from an empty prompt
Ctrl+LClear the screen; history stays in scrollback
Ctrl+UClear the input line
Ctrl+KDelete from the cursor to the end of the input

Editing#

KeyAction
Ctrl+ACopy the visible viewport plus nearby context
Ctrl+XCut the whole input line to the clipboard
Ctrl+VPaste text or an image from the clipboard
Ctrl+Z / Cmd+ZUndo the last input edit
Ctrl+W, Alt+BackspaceDelete the previous word
Ctrl+B / Ctrl+FMove by word
Ctrl+Left / Ctrl+RightMove by word
Home / EndMove to start / end of the input
Ctrl+SStash the input; press again to pop it back
Ctrl+RFuzzy reverse search over prompt history
TabAutocomplete the current token

Scrolling and navigation#

KeyAction
Up / DownScroll history when the input is empty
PageUp / PageDownPage the transcript
Ctrl+J / Ctrl+KJump to the next / previous prompt
Alt+U / Alt+DPage up / down
Ctrl+GBookmark a scroll position
Ctrl+PToggle typing scroll lock
Alt+XShow or dismiss the todo card
Alt+IToggle the info widget
Alt+J / Alt+KMove 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#

KeyAction
Shift+TabCycle favorite models
Ctrl+NToggle a favorite (inside the model picker)
Ctrl+OSet the session default model (inside the picker)
Alt+Left / Alt+RightDecrease / increase reasoning effort
Alt+Up / Alt+DownFaster / slower speed tier where supported
Alt+Shift+MShow or hide the diagram pane
Alt+MCycle the side panel: split, fullscreen, hidden
Alt+YToggle selection/copy mode
Alt+CToggle 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#

KeyAction
Ctrl+1..Ctrl+4Resize the side panel to 25/50/75/100%
Ctrl+H / Ctrl+LFocus chat / diagram / diffs
Ctrl+Left / Ctrl+RightCycle diagrams when the diagram pane is focused
h j k l or arrowsPan a focused diagram
[ / ]Zoom a diagram
+ / -Resize the diagram pane
Alt+GShow 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 →