From 1ae0833a727d35e01a27b904aa8000820acf8273 Mon Sep 17 00:00:00 2001 From: BillionClaw Date: Mon, 16 Mar 2026 01:54:18 +0800 Subject: [PATCH] docs: document xfce4-terminal and terminator keyboard protocol limitations (#2166) Co-authored-by: BillionClaw <267901332+BillionClaw@users.noreply.github.com> --- packages/coding-agent/docs/terminal-setup.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/packages/coding-agent/docs/terminal-setup.md b/packages/coding-agent/docs/terminal-setup.md index 6b12a765..74b0df2a 100644 --- a/packages/coding-agent/docs/terminal-setup.md +++ b/packages/coding-agent/docs/terminal-setup.md @@ -86,6 +86,17 @@ Add to `settings.json` (Ctrl+Shift+, or Settings → Open JSON file) to forward If you already have an `actions` array, add the objects to it. If the old fullscreen behavior persists, fully close and reopen Windows Terminal. +## xfce4-terminal, terminator + +These terminals have limited escape sequence support. Modified Enter keys like `Ctrl+Enter` and `Shift+Enter` cannot be distinguished from plain `Enter`, preventing custom keybindings such as `submit: ["ctrl+enter"]` from working. + +For the best experience, use a terminal that supports the Kitty keyboard protocol: +- [Kitty](https://sw.kovidgoyal.net/kitty/) +- [Ghostty](https://ghostty.org/) +- [WezTerm](https://wezfurlong.org/wezterm/) +- [iTerm2](https://iterm2.com/) +- [Alacritty](https://github.com/alacritty/alacritty) (requires compilation with Kitty protocol support) + ## IntelliJ IDEA (Integrated Terminal) The built-in terminal has limited escape sequence support. Shift+Enter cannot be distinguished from Enter in IntelliJ's terminal.