@whoisjeremylam/pi-waveterm-images

Enable image rendering in WaveTerm for pi-tui

Packages

Package details

extension

Install @whoisjeremylam/pi-waveterm-images from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:@whoisjeremylam/pi-waveterm-images

Package: @whoisjeremylam/pi-waveterm-images
Version: 1.0.1
Published: Jun 12, 2026
Downloads: not available
Author: whoisjeremylam
License: MIT
Types: extension
Size: 2 KB
Dependencies: 1 dependency · 0 peers

Pi manifest JSON

{
  "extensions": [
    "./waveterm-images.ts"
  ]
}

Security note

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

README

pi-waveterm-images

Enable image rendering in WaveTerm for pi-tui.

WaveTerm supports Kitty, iTerm2, and Sixel image protocols via @xterm/addon-image, but pi-tui doesn't recognize TERM_PROGRAM=waveterm yet. This extension enables image rendering by setting the capabilities directly.

Requirements

WaveTerm fork with image support: https://github.com/whoisjeremylam/waveterm-remote
- Branch: feat/image-rendering-support
- This fork includes @xterm/addon-image for Sixel, Kitty, and iTerm2 protocol support

Install

pi install npm:@whoisjeremylam/pi-waveterm-images

How it works

Detects TERM_PROGRAM=waveterm
Calls setCapabilities() to enable Kitty image protocol
Images will render inline in pi instead of showing [Image: image/png ...]

Testing

Build WaveTerm from the fork:

git clone https://github.com/whoisjeremylam/waveterm-remote.git
cd waveterm-remote
git checkout feat/image-rendering-support
./node_modules/.bin/task dev

In a WaveTerm terminal, run:

chafa --format=iterm2 image.png