@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