@pi-unipi/input-shortcuts
Keyboard shortcuts for Pi's input box. Stash and restore text, undo/redo, clipboard operations, thinking level toggle, and tab insertion — all via a vim-style chord overlay triggered by ALT+S.
Press ALT+S, a small overlay appears with key hints. Press a key, the action runs. The overlay closes automatically after 300ms or on ESC.
Shortcuts
| Chord | Action | Description |
|---|---|---|
ALT+S → S |
Stash/Restore | Save input to stash register, or restore it |
ALT+S → U |
Undo | Pop from undo buffer |
ALT+S → R |
Redo | Push current text forward, restore previous |
ALT+S → Y |
Copy | Copy input to system clipboard |
ALT+S → D |
Cut | Copy to clipboard, then clear input |
ALT+S → T |
Toggle Thinking | Cycle: off → low → medium → high → xhigh → off |
ALT+S → A → [0-9] |
Append Register | Append from numbered register 0-9 |
ALT+S → A → S |
Append Stash | Append from stash register |
ALT+I |
Tab Insert | Insert literal tab character |
Commands
| Command | Description |
|---|---|
/unipi:stash-settings |
Open settings TUI for keybinding customization |
Special Triggers
Input-shortcuts is a standalone package. It doesn't register with other packages or trigger coexists behavior.
Every action shows a brief success or error message in the status bar via ctx.ui.setStatus().
How It Works
Registers
- Stash register: 1 register for quick save/restore
- Numbered registers: 10 registers (0-9) for stored text snippets
- Persistence: Saved to
.unipi/config/input-shortcuts.json(per-project, atomic writes)
Undo/Redo
- In-memory ring buffer, max 50 snapshots per session
- 500ms debounce on snapshot creation (prevents noise from rapid typing)
- 1s throttle on undo (prevents rapid-fire undo)
- Redo buffer cleared on new snapshot
- Not persisted across sessions
Clipboard
Cross-platform clipboard detection with automatic fallback:
| Platform | Read | Write |
|---|---|---|
| Linux (X11) | xclip -selection clipboard -o |
xclip -selection clipboard |
| Linux (alt) | xsel --clipboard --output |
xsel --clipboard --input |
| macOS | pbpaste |
pbcopy |
| Windows | powershell Get-Clipboard |
clip / powershell Set-Clipboard |
Detected tool is cached after first use. Returns graceful error if no clipboard tool is available.
Thinking Toggle
Cycles through Pi's thinking levels: off → low → medium → high → xhigh → off.
Configurables
Run /unipi:stash-settings to customize keybindings:
- Chord trigger key — default
alt+s - Tab insert key — default
alt+i
Both cycle through available ALT key combinations, excluding known conflicts (alt+e = cursorWordRight).
Config persisted to ~/.unipi/config/input-shortcuts-config.json (global).
License
MIT