pi-imgcat
v0.3.6-1
Published
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).
Downloads
467
Maintainers
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 -ForceOr from npm:
pi install npm:pi-imgcatThen /reload in pi.
Usage
/img <IMAGE_PATH> # inline preview
/imgopen <IMAGE_PATH> # inline preview + full resolution in the OS viewerThe 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.
