Merge pull request #10069 from Kilo-Org/docs/windows-shift-enter-terminal

docs(cli): add Windows Terminal Shift+Enter configuration guide
This commit is contained in:
Catriel Müller
2026-05-08 10:14:19 -03:00
committed by GitHub
@@ -346,6 +346,43 @@ Both keys also accept object configuration for specific tools or language server
The TUI gives `Ctrl+Z` to input undo on Windows because native Windows terminals do not support POSIX terminal suspend. On Windows, `input_undo` defaults to `ctrl+z,ctrl+-,super+z` and `terminal_suspend` is disabled. On macOS and Linux, `terminal_suspend` defaults to `ctrl+z`.
#### Enabling Shift+Enter in Windows Terminal
Some terminals don't send modifier keys with Enter by default. Windows Terminal requires a one-time configuration to forward `Shift+Enter` as an escape sequence that Kilo can read.
Open your `settings.json` at:
```
%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json
```
Add this entry to the root-level `actions` array:
```json
"actions": [
{
"command": {
"action": "sendInput",
"input": "\u001b[13;2u"
},
"id": "User.sendInput.ShiftEnterCustom"
}
]
```
Add this entry to the root-level `keybindings` array:
```json
"keybindings": [
{
"keys": "shift+enter",
"id": "User.sendInput.ShiftEnterCustom"
}
]
```
Save the file and restart Windows Terminal or open a new tab. `Shift+Enter` will now insert a newline in the Kilo prompt instead of submitting the message.
### OpenTelemetry Export
Kilo telemetry is enabled by default and can be disabled with `experimental.openTelemetry = false`: