Keyboard reference¶

A complete reference for all keyboard shortcuts in ripple chat. Keys are grouped by function. For mouse support, see the note at the bottom of the page.

Text editing¶

These shortcuts work at the chat input prompt while typing a message.

Key	Action
`Ctrl`+`A`	Move cursor to the beginning of the line
`Ctrl`+`E`	Move cursor to the end of the line
`Ctrl`+`U`	Clear the entire input line
`Ctrl`+`W`	Delete the word to the left of the cursor
`Alt`+`Left`	Move cursor one word to the left
`Alt`+`Right`	Move cursor one word to the right
`Alt`+`Enter`	Insert a newline (multi-line input)

Session and turn control¶

Key	Action
`Ctrl`+`C`	Cancel the running agent turn (if one is in progress), or quit if the prompt is idle
`Ctrl`+`D`	Quit Ripple (same as `/quit`)
`Esc`	Deny a pending approval card and close it, or close an open overlay, or clear the input

Tip

Ctrl+C during a running turn stops the agent and returns you to the prompt. The turn's partial output remains visible in the transcript. Press Ctrl+C again at the idle prompt to quit.

These shortcuts scroll the conversation transcript above the input.

Key	Action
`Up`	Scroll up one line (when no overlay is open)
`Down`	Scroll down one line
`Page Up`	Scroll up one page
`Page Down`	Scroll down one page

When the slash command palette or a tool overlay (e.g. /model, /tools) is open, Up and Down navigate within the overlay instead.

Approval cards¶

When an approval card is shown for a gated tool call:

Key	Action
`A` or `Y`	Approve this call
`R`, `D`, or `N`	Reject this call
`Shift`+`A`	Always-Allow - approve this call and all future calls to this tool for the session
`E`	Edit the command (shell tool only)
`Enter`	Confirm the highlighted choice
`Up` / `Down`	Move between approval choices
`Esc`	Deny the pending approval and dismiss the card

Permission modes¶

Key	Action
`Tab`	Cycle the permission mode: `ask` -> `auto-reads` -> `plan` -> `accept-all` -> `ask`
`Tab` (second press, when armed at `accept-all`)	Confirm and activate `accept-all` ("YOLO") mode
`Esc` (when `accept-all` is armed but not confirmed)	Disarm and return to the previous mode

The current mode is shown in the status line with a color indicator: green (ask), amber (auto-reads), blue (plan), red (accept-all). See Approvals & permission modes for a full description of each mode.

Mouse support¶

Ripple's TUI supports mouse input in terminals that report mouse events. You can:

Click links in the transcript to open them (URLs rendered in Markdown output).
Click panes (e.g. the plan panel header) to expand or collapse them.
Click sidebar items when overlays such as the /model picker or /tools browser are open.

Mouse support depends on your terminal emulator's capabilities. If clicks don't register, check that mouse reporting is enabled in your terminal settings.