@mrclrchtr/supi-extras
v1.12.0
Published
SuPi extras — command aliases, skill shorthand, tab spinner, /supi-stash prompt stash with TUI overlay, and other small utilities
Maintainers
Readme
@mrclrchtr/supi-extras
Adds a bundle of small quality-of-life features to the pi coding agent.
Install
pi install npm:@mrclrchtr/supi-extrasFor local development:
pi install ./packages/supi-extras
What you get
This package mixes a few commands and shortcuts with a few always-on UI tweaks.
Commands
/exit— exit pi/e— alias for/exit/clear— start a new session (alias for/new)/supi-stash— browse, restore, copy, delete, or clear saved prompt drafts
Shortcuts
Alt+S— stash the current editor textAlt+C— copy the current editor text to the system clipboard$skill-name— input shorthand that expands to/skill:skill-name
The $skill-name helper also adds skill-only autocomplete while the cursor is inside a $... token.
Prompt stash
Prompt stash stores drafts in ~/.pi/agent/supi/prompt-stash.json so they survive restarts.
/supi-stash opens an overlay with these actions:
Enter— restore the selected draft into the editorc— copy the selected draft to the clipboardd— delete the selected draftD— clear all draftsEsc— close the overlay
If the stash file cannot be read or written, the feature degrades to in-memory use instead of breaking the extension.
Passive behavior
Tab-title spinner
While the agent is working, the package animates a spinner in the terminal tab title. When the turn finishes, it shows a done marker. If ask_user is active, the spinner pauses so the waiting-for-input title is not overwritten.
Footer model and effort colors
The footer keeps pi's existing information but recolors the active model and reasoning level using theme tokens.
Headless git safety
The package sets:
GIT_EDITOR=trueGIT_SEQUENCE_EDITOR=true
That prevents git subprocesses from hanging while waiting for an interactive editor.
Source
src/aliases.ts— command aliasessrc/prompt-stash.ts— prompt stash shortcuts, persistence, and overlaysrc/skill-shortcut.ts—$skill-nameexpansion and autocompletesrc/tab-spinner.ts— terminal tab-title spinnersrc/copy-prompt.tsandsrc/clipboard.ts— copy-to-clipboard shortcut and helpersrc/model-effort-colors.ts— footer recoloringsrc/git-editor.ts— git editor environment guard
