@guwidoe/pi-clipboard-image

pi extension: paste clipboard images into the prompt across Windows, Linux, and macOS

Package details

← Back
extension

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

npm report
$ pi install npm:@guwidoe/pi-clipboard-image
Package
@guwidoe/pi-clipboard-image
Version
0.2.0
Published
Feb 24, 2026
Downloads
67/mo · 24/wk
Author
guwidoe
License
MIT
Types
extension
Size
10.1 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

@guwidoe/pi-clipboard-image

Cross-platform clipboard image extension for pi.

Features

  • Alt+V shortcut to paste clipboard image into the prompt as @<temp-file>.png
  • paste-image command for manual triggering
  • Saves clipboard images as PNG and caps max dimension to 2000px
  • Multiple backends:
    • Windows: PowerShell clipboard API
    • Linux: Wayland (wl-paste) or X11 (xclip) + ImageMagick (convert)
    • macOS: pngpaste (optionally sips for resizing)

Install

pi install npm:@guwidoe/pi-clipboard-image

Platform notes

  • Windows: works in native Windows pi sessions.
  • Linux/WSL: requires clipboard tooling (wl-paste or xclip) and ImageMagick.
  • macOS: requires pngpaste (brew install pngpaste).