Skip to content

Keybindings

Defaults use no alt — mac friendly. Press f1 in the app to see every action and its current binding.

Input

ActionKeys
sendenter
newlineshift+enter (ctrl+j)
stop · clear · quit (2x)ctrl+c
cancel / close overlayesc
edit prompt in vimctrl+g
prompt historyup

ctrl+c behaves like Claude Code: one press stops a running generation; idle it clears the input; a second press within two seconds exits (with autosave).

Agents

ActionKeys
new agentctrl+n
next / prev agentctrl+→ / ctrl+←
close agentctrl+w

View & navigation

ActionKeys
cycle focustab (or click)
toggle dashboardsctrl+b
move focused panelshift+arrows
scroll outputpgup / pgdown
verbose chatctrl+o
cycle permission modeshift+tab
toggle thinkingctrl+t
helpf1
release mouse for terminal selectionf3

In chat focus: j/k scroll, u/d page, g/G top/bottom, y/Y copy last response/transcript.

In pickers

Every picker filters on what you type, so ordinary letters go to the filter.

ActionKeys
moveup/down, or ctrl+k/ctrl+j
selectenter
closeesc
disconnect a provider (/connect)ctrl+d, twice
drop a queued prompt (/queue)d
reorder a panel (/panels)left/right

ctrl+d rather than d in /connect precisely because the list filters: a plain d would put bedrock out of reach of typing.

Rare operations are slash commands by default: /new, /save, /resume, /model, /panels, /systemprompt, /settings.

shift+enter

Most terminals cannot transmit shift+enter distinctly — the same limitation Claude Code solves with /terminal-setup. Map it to a literal newline in your terminal and Tapioca picks it up (it equals ctrl+j). Kitty:

map shift+enter send_text all \n

Otherwise ctrl+j always works.

Rebinding

Everything is rebindable under [keys] in the config. Values are Bubble Tea key names; separate alternatives with commas; an empty string unbinds:

toml
[keys]
save_session = "ctrl+s,f5"

Available actions include send, newline, quit, cancel, verbose, edit_prompt, toggle_thinking, cycle_mode, new_agent, next_agent, prev_agent, close_agent, toggle_dashboard, move_panel_prev, move_panel_next, focus_next, help, copy_last, copy_all, save_session.

Released under the MIT License.