From 1349f02cdd360a6ba0a7640a1910f0d01dd0b627 Mon Sep 17 00:00:00 2001 From: badlogic Date: Mon, 5 Jan 2026 23:17:39 +0100 Subject: [PATCH] docs: document Windows Terminal Shift+Enter limitation Windows Terminal does not support the Kitty keyboard protocol, so Shift+Enter cannot be distinguished from Enter. Document that users should use Ctrl+Enter for multi-line input instead. - Add Windows Terminal note in Terminal Setup section - Update Keyboard Shortcuts table with Windows note - Show Windows-specific hint in /hotkeys command --- packages/coding-agent/README.md | 4 +++- .../coding-agent/src/modes/interactive/interactive-mode.ts | 2 +- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/packages/coding-agent/README.md b/packages/coding-agent/README.md index f857bb69..4fd9626f 100644 --- a/packages/coding-agent/README.md +++ b/packages/coding-agent/README.md @@ -138,6 +138,8 @@ config.enable_kitty_keyboard = true return config ``` +**Windows Terminal:** Does not support the Kitty keyboard protocol. Shift+Enter cannot be distinguished from Enter. Use Ctrl+Enter for multi-line input instead. All other keybindings work correctly. + ### API Keys & OAuth **Option 1: Auth file** (recommended) @@ -279,7 +281,7 @@ Both modes are configurable via `/settings`: "one-at-a-time" delivers messages o | Key | Action | |-----|--------| | Enter | Send message | -| Shift+Enter / Alt+Enter | New line (Ctrl+Enter on WSL) | +| Shift+Enter | New line (Ctrl+Enter on Windows Terminal) | | Ctrl+W / Option+Backspace | Delete word backwards | | Ctrl+U | Delete to start of line | | Ctrl+K | Delete to end of line | diff --git a/packages/coding-agent/src/modes/interactive/interactive-mode.ts b/packages/coding-agent/src/modes/interactive/interactive-mode.ts index ade871e1..a005298c 100644 --- a/packages/coding-agent/src/modes/interactive/interactive-mode.ts +++ b/packages/coding-agent/src/modes/interactive/interactive-mode.ts @@ -2485,7 +2485,7 @@ export class InteractiveMode { | Key | Action | |-----|--------| | \`${submit}\` | Send message | -| \`${newLine}\` | New line | +| \`${newLine}\` | New line${process.platform === "win32" ? " (Ctrl+Enter on Windows Terminal)" : ""} | | \`${deleteWordBackward}\` | Delete word backwards | | \`${deleteToLineStart}\` | Delete to start of line | | \`${deleteToLineEnd}\` | Delete to end of line |