@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