pi-imgcat

Display images inline in the pi coding agent: native protocol (iTerm2/Kitty/WezTerm/Ghostty), Sixel in Windows Terminal, ANSI half-blocks everywhere else (works under Herdr/tmux).

Packages

Package details

extension

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

npm repo home report

$ pi install npm:pi-imgcat

Package: pi-imgcat
Version: 0.3.6-1
Published: Sep 3, 2026
Downloads: 562/mo · 286/wk
Author: gelarria
License: MIT
Types: extension
Size: 481.5 KB
Dependencies: 0 dependencies · 3 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

pi-imgcat

Show images inline in the pi terminal.

Install

pi install git:github.com/GelArria/pi-imgcat
# optional, for real Sixel in Windows Terminal:
Install-Module Sixel -Scope CurrentUser -Force

Or from npm:

pi install npm:pi-imgcat

Then /reload in pi.

Usage

/img <IMAGE_PATH>          # inline preview
/imgopen <IMAGE_PATH>      # inline preview + full resolution in the OS viewer

The show_image tool is also available to the LLM (with an open: true flag for full resolution). Accepts local paths, http(s):// URLs, and data: URIs. The image is also sent to the model, so you can ask about it.

Rendering

Terminal	How
iTerm2, Kitty, WezTerm, Ghostty	native inline image (~60 cells wide)
Windows Terminal (direct)	Sixel (needs the `Sixel` PowerShell module)
Multiplexers (Herdr, tmux) or anything else	ANSI half-blocks — plain text, works everywhere

Over SSH from iTerm2, run $env:PI_IMAGE_PROTOCOL='iterm2' before pi (iTerm doesn't forward its session id).

No npm dependencies. Sixel helpers adapted from pi-image-tools (MIT). License: MIT.