pi-warp-kitty-images
v1.0.0
Published
Enable Kitty image protocol for Warp terminal in pi's TUI
Readme
🖼️ pi-warp-kitty-images
Kitty graphics protocol for Warp terminal in pi
Enable images, true color, and hyperlinks in Warp's TUI.
The Problem
Warp supports the Kitty graphics protocol, but pi-tui's capability detection doesn't recognize it. Images, true color, and hyperlinks are silently disabled — even though Warp handles them perfectly.
The Solution
pi-warp-kitty-images force-enables image rendering, true color, and hyperlinks when TERM_PROGRAM=warpterminal:
| Capability | Before | After | |-----------|--------|-------| | Images | ❌ Disabled | ✅ Kitty protocol | | True Color | ❌ Disabled | ✅ 24-bit color | | Hyperlinks | ❌ Disabled | ✅ OSC 8 links |
Installation
pi install pi-warp-kitty-imagesOr manually clone into your pi extensions directory.
How It Works
On every session_start, the extension checks TERM_PROGRAM. If it equals WarpTerminal, it patches TUI capabilities via pi-tui's setCapabilities() API:
pi.tui.setCapabilities({
images: "kitty",
trueColor: true,
hyperlinks: true,
});No configuration needed — it just works.
Requirements
License
MIT
