video-paste

Pi extension that adds video paste support and video-aware inspection through the read tool.

Package details

extension

Install video-paste from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:video-paste
Package
video-paste
Version
0.1.0
Published
Mar 16, 2026
Downloads
18/mo · 5/wk
Author
avichalp
License
MIT
Types
extension
Size
34.5 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

video-paste

A Pi extension that adds video paste support and makes Pi's read tool video-aware.

Features

  • pastes copied local video file paths into the editor using Pi's normal paste flow
  • keeps native image paste working by falling back to Pi's built-in image handling
  • upgrades read so common video files can be inspected directly
  • returns video metadata from ffprobe
  • returns sampled keyframes as image attachments
  • rewrites bare path-only prompts like ~/Movies/demo.mp4 into an explicit video inspection request

Requirements

  • ffprobe
  • ffmpeg

Install

From GitHub

pi install git:github.com/avichalp/video-paste

Local dev / quick test

pi -e .

Run that from this repo root. Do not use -e . at the same time as a global symlinked install.

Manual install

Symlink or copy this folder into one of these locations:

  • ~/.pi/agent/extensions/ for global use
  • .pi/extensions/ for project-local use

Usage

  1. Copy a local video file in Finder / your file manager, or copy a local video file path.
  2. In Pi, use the normal image paste shortcut.
    • macOS/Linux: Ctrl+V
    • Windows: Alt+V if you use Pi defaults
  3. The video path is inserted into the editor.
  4. Submit the message.
  5. Pi inspects the video through read and returns metadata plus sampled frames.

Notes

  • This is a standard Pi extension. It does not add a new native video message type.
  • Drag and drop already pastes file paths in many terminals; this extension mainly improves paste behavior and makes read understand video files.
  • After you publish to npm, users will be able to install it with pi install npm:video-paste.