From b621f3eefdc51a7f0f3b663b97f4950bc4e16dab Mon Sep 17 00:00:00 2001 From: Fero Date: Mon, 9 Mar 2026 13:31:42 +0100 Subject: [PATCH] docs(coding-agent): explain Windows Terminal Alt+Enter remap (#1967) --- packages/coding-agent/README.md | 2 ++ packages/coding-agent/docs/terminal-setup.md | 12 ++++++++++-- 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/packages/coding-agent/README.md b/packages/coding-agent/README.md index 3fd951c4..56961e85 100644 --- a/packages/coding-agent/README.md +++ b/packages/coding-agent/README.md @@ -186,6 +186,8 @@ Submit messages while the agent is working: - **Escape** aborts and restores queued messages to editor - **Alt+Up** retrieves queued messages back to editor +On Windows Terminal, `Alt+Enter` is fullscreen by default. Remap it in [docs/terminal-setup.md](docs/terminal-setup.md) so pi can receive the follow-up shortcut. + Configure delivery in [settings](docs/settings.md): `steeringMode` and `followUpMode` can be `"one-at-a-time"` (default, waits for response) or `"all"` (delivers all queued at once). `transport` selects provider transport preference (`"sse"`, `"websocket"`, or `"auto"`) for providers that support multiple transports. --- diff --git a/packages/coding-agent/docs/terminal-setup.md b/packages/coding-agent/docs/terminal-setup.md index 2e68287d..6b12a765 100644 --- a/packages/coding-agent/docs/terminal-setup.md +++ b/packages/coding-agent/docs/terminal-setup.md @@ -63,7 +63,7 @@ Add to `keybindings.json` to enable `Shift+Enter` for multi-line input: ## Windows Terminal -Add to `settings.json` (Ctrl+Shift+, or Settings → Open JSON file): +Add to `settings.json` (Ctrl+Shift+, or Settings → Open JSON file) to forward the modified Enter keys pi uses: ```json { @@ -71,12 +71,20 @@ Add to `settings.json` (Ctrl+Shift+, or Settings → Open JSON file): { "command": { "action": "sendInput", "input": "\u001b[13;2u" }, "keys": "shift+enter" + }, + { + "command": { "action": "sendInput", "input": "\u001b[13;3u" }, + "keys": "alt+enter" } ] } ``` -If you already have an `actions` array, add the object to it. +- `Shift+Enter` inserts a new line. +- Windows Terminal binds `Alt+Enter` to fullscreen by default. That prevents pi from receiving `Alt+Enter` for follow-up queueing. +- Remapping `Alt+Enter` to `sendInput` forwards the real key chord to pi instead. + +If you already have an `actions` array, add the objects to it. If the old fullscreen behavior persists, fully close and reopen Windows Terminal. ## IntelliJ IDEA (Integrated Terminal)