From d606df81263dcd4a791f438031f08f3b5bd639e3 Mon Sep 17 00:00:00 2001 From: teknium1 <127238744+teknium1@users.noreply.github.com> Date: Fri, 8 May 2026 16:25:27 -0700 Subject: [PATCH] docs(cli): call out Ctrl+Enter for Windows Terminal users Windows Terminal captures Alt+Enter at the terminal layer (fullscreen toggle), so documenting 'Alt+Enter or Ctrl+J' without qualification leaves stock Windows Terminal users with no working newline key they can discover from the docs alone. - Main keybindings row: note Alt+Enter is intercepted on WT and direct users to Ctrl+Enter / Ctrl+J instead. - Shift+Enter compatibility table: split 'stock Windows Terminal' from Windows Terminal Preview 1.25+ (which added Kitty protocol support and works with the keybinding from this PR once enabled). - Add AUTHOR_MAP entry for ra2157218@gmail.com -> Abd0r so the salvage commit passes the email-mapping CI gate. --- scripts/release.py | 1 + website/docs/user-guide/cli.md | 7 ++++--- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/scripts/release.py b/scripts/release.py index 33c9bd8097..c034cd20c3 100755 --- a/scripts/release.py +++ b/scripts/release.py @@ -57,6 +57,7 @@ AUTHOR_MAP = { "128259593+Gutslabs@users.noreply.github.com": "Gutslabs", "50326054+nocturnum91@users.noreply.github.com": "nocturnum91", "223003280+Abd0r@users.noreply.github.com": "Abd0r", + "ra2157218@gmail.com": "Abd0r", "abdielv@proton.me": "AJV20", "mason@growagainorchids.com": "masonjames", "ytchen0719@gmail.com": "liquidchen", diff --git a/website/docs/user-guide/cli.md b/website/docs/user-guide/cli.md index 997c58cad8..d7f41d7df8 100644 --- a/website/docs/user-guide/cli.md +++ b/website/docs/user-guide/cli.md @@ -92,7 +92,7 @@ When resuming a previous session (`hermes -c` or `hermes --resume `), a "Pre | Key | Action | |-----|--------| | `Enter` | Send message | -| `Alt+Enter`, `Ctrl+J`, or `Shift+Enter` | New line (multi-line input). `Shift+Enter` requires a terminal that distinguishes it from `Enter` — see below. | +| `Alt+Enter`, `Ctrl+J`, or `Shift+Enter` | New line (multi-line input). `Shift+Enter` requires a terminal that distinguishes it from `Enter` — see below. On Windows Terminal, `Alt+Enter` is captured by the terminal (fullscreen toggle); use `Ctrl+Enter` or `Ctrl+J` instead. | | `Alt+V` | Paste an image from the clipboard when supported by the terminal | | `Ctrl+V` | Paste text and opportunistically attach clipboard images | | `Ctrl+B` | Start/stop voice recording when voice mode is enabled (`voice.record_key`, default: `ctrl+b`) | @@ -225,9 +225,10 @@ Most terminals send the same byte sequence for `Enter` and `Shift+Enter` by defa |---|---| | Kitty, foot, WezTerm, Ghostty | Distinct `Shift+Enter` enabled by default | | iTerm2 (recent), Alacritty, VS Code terminal, Warp | Supported once the Kitty protocol is enabled in settings | -| macOS Terminal.app, stock Windows Terminal | Not supported — `Shift+Enter` is indistinguishable from `Enter` | +| Windows Terminal Preview 1.25+ | Supported once the Kitty protocol is enabled in settings | +| macOS Terminal.app, stock Windows Terminal (stable) | Not supported — `Shift+Enter` is indistinguishable from `Enter` | -Where the terminal cannot distinguish them, `Alt+Enter` and `Ctrl+J` continue to work everywhere. +Where the terminal cannot distinguish them, `Alt+Enter` and `Ctrl+J` continue to work everywhere. **On Windows Terminal specifically, `Alt+Enter` is captured by the terminal (toggles fullscreen) and never reaches Hermes — use `Ctrl+Enter` (delivered as `Ctrl+J`) or `Ctrl+J` directly for a newline.** ## Interrupting the Agent