pi-image-drop

Pi extension that turns terminal-dropped image paths into inline image attachments

Packages

Package details

extension

Install pi-image-drop from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-image-drop
Package
pi-image-drop
Version
0.1.2
Published
Aug 8, 2026
Downloads
285/mo · 285/wk
Author
tommyfork
License
MIT
Types
extension
Size
14.9 KB
Dependencies
0 dependencies · 2 peers
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

pi-image-drop

npm version Pi package MIT license

A Pi coding-agent extension for macOS terminal workflows. Drop an image file into the Pi prompt and it is displayed as [Image #1] while you write, then submitted as a real image attachment instead of a raw file path.

Features

  • Converts terminal-dropped local image paths into image attachments.
  • Shows numbered placeholders such as [Image #1] in the prompt editor before submission.
  • Supports multiple images and preserves surrounding prompt text.
  • Handles macOS shell escaping, quotes, spaces, Unicode spaces, tabs, and multiline input.
  • Supports PNG, JPEG, GIF, WebP, and BMP files.
  • Ignores missing, unreadable, invalid, empty, or over-50-MB files.
  • Uses Pi's image resize/conversion pipeline when available.

Requirements

  • Pi coding agent with extension support.
  • A terminal that provides dropped file paths, such as macOS Terminal, iTerm2, or Ghostty.
  • A Pi version with ctx.ui.onTerminalInput() and image input support.

Install

Install the published package through Pi:

pi install npm:pi-image-drop

Try the latest package for one run without changing your settings:

pi -e npm:pi-image-drop

Pin a reviewed npm release in shared configuration:

pi install npm:pi-image-drop@0.1.0

You can also install directly from GitHub:

pi install git:github.com/TommyFork/pi-image-drop

After installing, restart Pi or run /reload.

Install from a local checkout

git clone https://github.com/TommyFork/pi-image-drop.git
cd pi-image-drop
pi install .

For development or review without installing:

pi -e ./extensions/image-drop.ts

Usage

  1. Start Pi with the extension installed.
  2. Drag an image file into the prompt editor.
  3. The dropped path should immediately become [Image #1].
  4. Add text or more images as needed.
  5. Submit the prompt. Pi receives the images as attachments.

A dropped path that cannot be read or processed remains ordinary text when submitted.

Development

The extension is loaded directly as TypeScript by Pi and has no build step.

git clone https://github.com/TommyFork/pi-image-drop.git
cd pi-image-drop
pi -e ./extensions/image-drop.ts

Before opening a pull request, verify the package contents:

npm pack --dry-run

License

MIT