pi-stash

pi-stash is a pi extension for parking an in-progress draft, sending something else, then restoring the draft afterward.

Requirements

• pi running on Node.js >=22.19.0; Pi 0.78.1 or newer is the current tested baseline
• npm for local validation and publishing

Install

From npm:

pi install npm:@fitchmultz/pi-stash

From GitHub:

pi install https://github.com/fitchmultz/pi-stash

For local development:

npm install
pi install .

Then run /reload inside pi.

Compatibility note: this package is tested against the current pi release during each package update, and pi-bundled runtime packages are declared as optional wildcard peers. Pi 0.78.1 is the current tested floor, not a hard npm peer requirement. That keeps installs forward-open for future pi releases: npm peer ranges should not block users from trying a newer pi, though runtime behavior is only verified against the tested baseline until a follow-up package release confirms it.

Development and validation

pi loads the extension from the source .ts files, but local tests are transpiled into .tmp/test-dist/ before Node runs them so validation works on the declared Node 22.19 floor.

npm run ci          # typecheck + transpiled tests
npm run test:node22 # explicit Node 22.19 compatibility check
npm run validate    # ci + Node 22.19 check + audit + pack dry-run

Design

• Ctrl+Shift+S stashes the current editor text and clears the editor.
• Ctrl+Shift+R restores immediately when there is one stash, or opens a picker when there are multiple stashes.
• The stash picker supports arrow-key navigation, Enter to restore, Ctrl+D to delete the selected stash, and Ctrl+X to clear all stashes.
• In non-TUI clients such as RPC, restore falls back to a replace-editor confirmation for the latest stash, and /stash-list prints a latest-first summary instead of trying to open the TUI picker.
• Restores use pasteToEditor() when the editor already has text, so retrieval does not destroy whatever is currently in the box.
• Drafts are kept as a small LIFO stack, so repeated stashes still work naturally.
• The current stash stack is persisted in session metadata, so /reload, session resume, and /tree branch navigation keep drafts aligned with the active branch.
• A footer status shows how many drafts are currently stashed.

Commands

• /stash — stash the current editor text
• /stash some text — stash explicit text exactly as provided, including leading or trailing whitespace
• /stash-list — browse, restore, delete, or clear stashes

Why Ctrl+Shift+R for retrieval?

Ctrl+Shift+S appears free in the current pi keybinding docs, and Ctrl+Shift+R is also currently unassigned and mnemonic for restore.

Usage flow

1. Start typing a draft.
2. Press Ctrl+Shift+S.
3. Type and send the interrupting message.
4. Press Ctrl+Shift+R.
5. If needed, pick a different stash with the arrow keys or delete one with Ctrl+D.
6. Keep going with the restored draft.