All packages Compare

pi-image-drop

extensionmaintained

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

by — · v0.1.2 · published 20h ago

$ pi install npm:pi-image-drop
downloads/mo
426
stars
1
last push
18h ago
open issues
0

Signals

license: MITtestspi manifest: missinginstall size: —deps: 0peer deps: 0

Download trend

426 downloads · last 12 weeks (weekly)

vision
npm ↗ repo ↗

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