@mrclrchtr/supi-extras

SuPi extras — command aliases, skill shorthand, tab spinner, /supi-stash prompt stash with TUI overlay, and other small utilities

Packages

Package details

extension

Install @mrclrchtr/supi-extras from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@mrclrchtr/supi-extras
Package
@mrclrchtr/supi-extras
Version
2.5.0
Published
Jul 19, 2026
Downloads
3,574/mo · 438/wk
Author
mrclrchtr
License
MIT
Types
extension
Size
179.4 KB
Dependencies
2 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/extension.ts"
  ],
  "image": "https://raw.githubusercontent.com/mrclrchtr/supi/main/screenshots/supi-extras-stash.png"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@mrclrchtr/supi-extras

Adds a bundle of small quality-of-life features to the pi coding agent.

Install

pi install npm:@mrclrchtr/supi-extras

For local development:

pi install ./packages/supi-extras

Stash picker overlay

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 text
  • Alt+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 editor
  • c — copy the selected draft to the clipboard
  • d — delete the selected draft
  • D — clear all drafts
  • Esc — 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 replacement

The package replaces pi's default footer. The model name is colored by provider using theme tokens; thinking level coloring delegates to Pi's theme.

Headless git safety

The package sets:

  • GIT_EDITOR=true
  • GIT_SEQUENCE_EDITOR=true

That prevents git subprocesses from hanging while waiting for an interactive editor.

Source

  • src/aliases.ts — command aliases
  • src/prompt-stash.ts — prompt stash shortcuts, persistence, and overlay
  • src/skill-shortcut.ts — $skill-name expansion and autocomplete
  • src/tab-spinner.ts — terminal tab-title spinner
  • src/copy-prompt.ts and src/clipboard.ts — copy-to-clipboard shortcut and helper
  • src/supi-footer.ts — footer replacement
  • src/supi-footer-helpers.ts — pure helpers
  • src/git-editor.ts — git editor environment guard