@saifymatteo/pi-clipboard-image

Attaches clipboard images to the draft, including copied image files on Windows.

Packages

Package details

extension

Install @saifymatteo/pi-clipboard-image from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@saifymatteo/pi-clipboard-image
Package
@saifymatteo/pi-clipboard-image
Version
0.1.4
Published
Nov 7, 2026
Downloads
784/mo · 784/wk
Author
saifymatteo
License
AGPL-3.0-only
Types
extension
Size
54.8 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/saifymatteo/pi-extensions/main/packages/pi-clipboard-image/screenshot.png",
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

Clipboard image attachment

Alt+V pastes a clipboard image into the draft as [Image #1]

Alt+V adds the clipboard image to the draft as [Image #1]. Sending the message sends the image to the model with it.

Attaches clipboard images to the draft, including copied image files on Windows.

Try locally

From the repository root:

pi -e ./packages/pi-clipboard-image

This uses your normal personal resources unless you isolate the agent home. Follow the root README to avoid loading an existing copy of the extension. Nothing is installed globally.

Configuration and requirements

Registers Alt+V and Ctrl+Alt+V. Uses OS clipboard tools/native clipboard support and temporary image files. Windows/WSL use PowerShell; macOS and Linux use platform-specific clipboard mechanisms. See source for fallbacks; platform behavior needs manual verification.

Compatibility and safety

Reads clipboard image/file data and places it in the draft. Sending the draft transmits attachments to the selected model. Requires interactive terminal support; terminal shortcuts may intercept the key.

Imported host APIs are declared as peer dependencies and supplied by the Pi host. A * peer range describes host resolution, not a guarantee of compatibility with every release. See root verification notes for what was actually exercised.

Status

Part of the pi-extensions collection. No personal settings or credentials are included; see NOTICE.md for licensing and provenance.