76 lines
2.4 KiB
Markdown
76 lines
2.4 KiB
Markdown
# Pi Reserved Keybindings
|
||
|
||
Extensions **cannot** override these shortcuts — they are silently skipped by `registerShortcut()`.
|
||
|
||
| Key | Action |
|
||
|-----|--------|
|
||
| `escape` | interrupt |
|
||
| `ctrl+c` | clear / copy |
|
||
| `ctrl+d` | exit |
|
||
| `ctrl+z` | suspend |
|
||
| `shift+tab` | cycleThinkingLevel |
|
||
| `ctrl+p` | cycleModelForward |
|
||
| `ctrl+shift+p` | cycleModelBackward |
|
||
| `ctrl+l` | selectModel |
|
||
| `ctrl+o` | expandTools |
|
||
| `ctrl+t` | toggleThinking |
|
||
| `ctrl+g` | externalEditor |
|
||
| `alt+enter` | followUp |
|
||
| `enter` | submit / selectConfirm |
|
||
| `ctrl+k` | deleteToLineEnd |
|
||
|
||
## Non-Reserved Built-in Keys
|
||
|
||
Extensions **can** override these (Pi will warn but allow it).
|
||
|
||
| Key | Action |
|
||
|-----|--------|
|
||
| `up` / `down` | cursor / select navigation |
|
||
| `left` / `right` | cursor movement |
|
||
| `ctrl+a` | cursorLineStart |
|
||
| `ctrl+b` | cursorLeft |
|
||
| `ctrl+e` | cursorLineEnd |
|
||
| `ctrl+f` | cursorRight |
|
||
| `ctrl+n` | toggleSessionNamedFilter |
|
||
| `ctrl+r` | renameSession |
|
||
| `ctrl+s` | toggleSessionSort |
|
||
| `ctrl+u` | deleteToLineStart |
|
||
| `ctrl+v` | pasteImage |
|
||
| `ctrl+w` | deleteWordBackward |
|
||
| `ctrl+y` | yank |
|
||
| `ctrl+]` | jumpForward |
|
||
| `ctrl+-` | undo |
|
||
| `ctrl+alt+]` | jumpBackward |
|
||
| `alt+b` | cursorWordLeft |
|
||
| `alt+d` | deleteWordForward |
|
||
| `alt+f` | cursorWordRight |
|
||
| `alt+y` | yankPop |
|
||
| `alt+up` | dequeue |
|
||
| `alt+backspace` | deleteWordBackward |
|
||
| `alt+delete` | deleteWordForward |
|
||
| `alt+left` / `alt+right` | cursorWord left/right |
|
||
| `ctrl+left` / `ctrl+right` | cursorWord left/right |
|
||
| `shift+enter` | newLine |
|
||
| `home` / `end` | cursorLineStart/End |
|
||
| `pageUp` / `pageDown` | page navigation |
|
||
| `backspace` | deleteCharBackward |
|
||
| `delete` | deleteCharForward |
|
||
| `tab` | tab |
|
||
|
||
## Safe Keys for Extensions
|
||
|
||
These `ctrl+letter` combos are **free** and work in all terminals:
|
||
|
||
| Key | Notes |
|
||
|-----|-------|
|
||
| `ctrl+x` | Safe |
|
||
| `ctrl+q` | May be intercepted by terminal (XON/XOFF flow control) |
|
||
| `ctrl+h` | Alias for backspace in some terminals — use with caution |
|
||
|
||
## macOS Notes
|
||
|
||
- `alt+letter` combos type special characters in most macOS terminals — they don't send alt sequences
|
||
- `ctrl+shift+letter` requires Kitty keyboard protocol (Kitty, Ghostty, WezTerm)
|
||
- `ctrl+alt+letter` works in legacy terminals but may conflict with macOS system shortcuts
|
||
- **Safest bet on macOS:** stick to `ctrl+letter` combos from the free list above, or use `f1`–`f12`
|