---
title: Keys
description: 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.
section: cli
order: 30
audience: [user]
sources: [cli/src/keys.ts, cli/src/gears.ts, cli/src/copy.ts, cli/src/agents-panel.ts, packages/harness/src/extensions/permissions.ts, plugins/github-prs/src/index.ts]
features: [cli.keys, cli.copy]
---

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.

```text
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 {#leader}

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.

```yaml
keys:
  leader: ctrl+b
  leader_bindings:
    r: /routes 1h
    t: null
```

## Direct shortcuts {#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 {#pi-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 {#copy}

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 {#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. |
