Keys
The leader key (ctrl+g) and what each key after it does, the direct shortcuts venom adds, pi's own keys, and copying text out of the TUI.
venom's keys come in two kinds: the leader (a tmux-style prefix: press ctrl+g, let go, then one key) and direct shortcuts. The leader works in every terminal, including ones where alt doesn't reach the app (iTerm2's default Option key, for one), so every venom action has a leader binding.
ctrl+g m cycle permission modes
ctrl+g 2 shift to gear 2
ctrl+g ? list every leader binding
ctrl+g ctrl+g pi's external editor (the leader twice sends ctrl+g itself)The leader's bindings
Press ctrl+g ? in a session for the list as configured. The defaults:
| Keys | What they do |
|---|---|
ctrl+g 1 … ctrl+g 9 |
Shift to gear 1–9. |
ctrl+g up, ctrl+g +, ctrl+g = |
Shift up a gear. |
ctrl+g down, ctrl+g - |
Shift down a gear. |
ctrl+g g |
Pick a gear from a list. |
ctrl+g m |
Cycle the permission mode (same as alt+m). |
ctrl+g M |
Toggle multiple subagents mode (/subagents toggle). |
ctrl+g s |
Toggle sudo: no prompts, no sandbox (same as alt+s). |
ctrl+g a |
Show or hide the agents panel (same as alt+a). |
ctrl+g o |
List this session's agents (/ps). |
ctrl+g b |
The board's notes (/board). |
ctrl+g w |
Switch the chat between the capped reading width and the full terminal width. |
ctrl+g W |
List the git worktrees venom made (/workspace list). |
ctrl+g u |
Commit and push the current workspace upstream (/workspace push). |
ctrl+g v |
Cycle the transcript verbosity (/verbose). |
ctrl+g h |
Switch the HUD between compact and full (/hud). |
ctrl+g t |
The next colour theme (/theme next). |
ctrl+g c |
Copy the latest answer (/copy). |
ctrl+g n |
Mute or unmute sounds (/sounds toggle). |
ctrl+g x |
Clear the images and files attached to the prompt you are writing. |
ctrl+g p |
Show or hide the pull requests pane (/prs; from the bundled pull requests plugin). |
ctrl+g ? |
The cheat sheet: every binding as configured. |
ctrl+g ctrl+g |
Send ctrl+g itself: pi's external editor. |
ctrl+g Esc |
Cancel. |
A key that isn't bound cancels the leader, as does waiting longer than the timeout (1.5 seconds by default). While the leader waits, the HUD shows it.
The leader key, its timeout and its bindings are set in venom.yaml under keys: keys.leader (default ctrl+g), keys.leader_timeout_ms (default 1500) and keys.leader_bindings, a map from a key to an action. An action is gear <n|up|down|pick>, mode, sudo, panel, width, verbose, theme, copy, attach clear, help or any slash command (/cost today); null or none removes a default. Plugins can add bindings for keys that are still free. keys.gear_hotkeys: false turns off the direct gear shortcuts below.
keys:
leader: ctrl+b
leader_bindings:
r: /routes 1h
t: nullDirect shortcuts
| Key | What it does |
|---|---|
alt+m |
Cycle the permission mode: plan, default, accept-edits, auto, yolo. |
alt+s |
Toggle sudo for this session. |
alt+a |
Show or hide the agents panel. |
alt+1 … alt+9 (alt+<n>) |
Shift to gear 1–9. |
alt+., alt+, |
Shift up, down a gear. |
shift+F1 … shift+F12 |
Shift to gear 1–12 (xterm-style terminals, iTerm2, Ghostty, WezTerm, kitty, Windows Terminal, tmux; not rxvt or the Linux console). |
pi's keys
The keys pi binds keep working. The ones used most:
| Key | What it does |
|---|---|
Esc |
Interrupt the agent. |
ctrl+c |
Clear the editor; twice to exit. With a selection, copy it. |
ctrl+d |
Exit (empty editor). |
shift+tab |
Cycle the thinking level. |
ctrl+l |
Pick a model. |
ctrl+p, shift+ctrl+p |
Cycle through the models of --models. |
ctrl+o |
Expand tool output, thinking and the startup header. |
ctrl+t |
Collapse or expand thinking blocks. |
alt+enter |
Queue a follow-up message for after the run. |
alt+up |
Put queued messages back in the editor. |
ctrl+v |
Paste an image, files or text from the clipboard. |
shift+enter, ctrl+j |
New line in the editor. |
ctrl+shift+f |
Search the transcript (fullscreen). |
ctrl+z |
Suspend to the background. |
/ |
Commands. |
! |
Run a shell command. |
/hotkeys lists every active key. pi's keys are rebound in ~/.venom/agent/keybindings.json.
Copying text
The TUI is fullscreen by default and tracks the mouse, so a plain drag selects inside venom instead of in the terminal. Drag, double-click a word or triple-click a line; the selection is copied on release:
- on your own machine, through the system clipboard tool;
- inside tmux, into tmux's buffer (and through tmux to the outer terminal's clipboard);
- over ssh, through OSC 52.
ctrl+c with a selection copies it and clears the selection. /copy (or ctrl+g c) copies the latest answer, /copy 2 the one before it, with a picker of its code blocks when it has any. For terminal-native selection, start with --tui-mode regular.
Troubleshooting
| Symptom | Fix |
|---|---|
alt+m types a character |
Your terminal sends Option as a character (iTerm2's default). Use ctrl+g m, or set Option to send Esc+. |
shift+F3 does something else |
rxvt, the Linux console and some Terminal.app setups send other codes. Use ctrl+g 3 or alt+3. |
ctrl+g no longer opens the external editor |
It is the leader: press it twice. |
| Copy doesn't reach the clipboard in tmux | Update tmux, or set -g set-clipboard on; OSC 52 needs the outer terminal's support. |