From 0abc61987d17482c3a0a878e7db58f4a6a50144b Mon Sep 17 00:00:00 2001 From: Tom Boucher Date: Tue, 17 Mar 2026 10:19:13 -0400 Subject: [PATCH] fix: add Alt+V as clipboard image paste shortcut on macOS and document it (#852) (#854) --- docs/commands.md | 3 +++ packages/pi-coding-agent/src/core/keybindings.ts | 2 +- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/commands.md b/docs/commands.md index 8805c9d67..188314b5f 100644 --- a/docs/commands.md +++ b/docs/commands.md @@ -74,9 +74,12 @@ See [Parallel Orchestration](./parallel-orchestration.md) for full documentation | `Ctrl+Alt+G` | Toggle dashboard overlay | | `Ctrl+Alt+V` | Toggle voice transcription | | `Ctrl+Alt+B` | Show background shell processes | +| `Ctrl+V` / `Alt+V` | Paste image from clipboard (screenshot → vision input) | | `Escape` | Pause auto mode (preserves conversation) | > **Note:** In terminals without Kitty keyboard protocol support (macOS Terminal.app, JetBrains IDEs), slash-command fallbacks are shown instead of `Ctrl+Alt` shortcuts. +> +> **Tip:** If `Ctrl+V` is intercepted by your terminal (e.g. Warp), use `Alt+V` instead for clipboard image paste. ## CLI Flags diff --git a/packages/pi-coding-agent/src/core/keybindings.ts b/packages/pi-coding-agent/src/core/keybindings.ts index 958560121..29bc8b967 100644 --- a/packages/pi-coding-agent/src/core/keybindings.ts +++ b/packages/pi-coding-agent/src/core/keybindings.ts @@ -65,7 +65,7 @@ export const DEFAULT_APP_KEYBINDINGS: Record = { externalEditor: "ctrl+g", followUp: "alt+enter", dequeue: "alt+up", - pasteImage: process.platform === "win32" ? "alt+v" : "ctrl+v", + pasteImage: process.platform === "win32" ? "alt+v" : ["ctrl+v", "alt+v"], newSession: [], tree: [], fork: [],