Pi Superwhisper Paste

Windows-focused Pi bridge that pastes Superwhisper clipboard output into Pi's TUI editor.

What this is

Superwhisper can paste dictated text into normal Windows apps, but terminal TUIs can be a rough edge. In the original case, dictation worked in Notepad and PowerShell, and Typeless worked in Pi, but Superwhisper's automatic paste did not reliably reach Pi's TUI editor without a manual Ctrl+V.

This package bridges that gap from the Pi side: it watches the Windows clipboard, detects new Superwhisper output, and inserts it into the active Pi editor with Pi's extension API.

The official Superwhisper Pi package (@superwhisper/pi) targets the deeplink/macOS flow. If you need the clipboard-based Windows workaround, use this package.

Features

• Default-on after the extension loads on Windows.
• Slash commands: /sw-paste:on and /sw-paste:off.
• Windows clipboard polling with active-tab gating.
• Brief copy-suppression window so local terminal copy actions do not get auto-pasted back into Pi.
• Clipboard-owner filtering so terminal/CLI-owned clipboard updates stay blocked by default.

Install

Install the published npm package with Pi:

pi install npm:pi-superwhisper-paste

Pin a specific version when you want reproducible installs:

pi install npm:[email protected]

Install into the current project instead of your user Pi settings:

pi install npm:pi-superwhisper-paste -l

Or install from GitHub:

pi install git:github.com/eiei114/pi-superwhisper-paste

Try it without permanently installing:

pi -e npm:pi-superwhisper-paste

Official Superwhisper package

If you are using the official Superwhisper Pi integration instead:

pi install npm:@superwhisper/pi

Docs: https://superwhisper.com/pi

Quick start

After install, start Pi and dictate with Superwhisper. New Superwhisper clipboard output should auto-paste into the active Pi editor when the bridge is on.

Toggle the bridge at runtime:

/sw-paste:off
/sw-paste:on

Try this package locally from a clone:

pi -e .

Package contents

| Path | Purpose | |---|---| | extensions/index.ts | Pi TypeScript extension entrypoint | | docs/examples.md | Usage examples | | docs/release.md | Trusted Publishing release flow | | docs/template-checklist.md | Maintainer template checklist | | CHANGELOG.md | Version history | | LICENSE | MIT license |

Development

npm install
npm run ci

Release

This package is set up for npm Trusted Publishing, so no NPM_TOKEN is required.

npm version patch
git push

See docs/release.md for setup details.

Security

Pi packages can execute code with your local permissions. Review extensions before installing third-party packages.

For vulnerability reporting, see SECURITY.md.

Links

• npm: https://www.npmjs.com/package/pi-superwhisper-paste
• GitHub: https://github.com/eiei114/pi-superwhisper-paste
• Issues: https://github.com/eiei114/pi-superwhisper-paste/issues
• Official Superwhisper Pi package: https://superwhisper.com/pi — @superwhisper/pi on npm (pi install npm:@superwhisper/pi)

License

MIT