pi-warp-kitty-images

Enable Kitty image protocol for Warp terminal in pi's TUI

Packages

Package details

extension

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

npm report
$ pi install npm:pi-warp-kitty-images
Package
pi-warp-kitty-images
Version
1.0.0
Published
Jun 15, 2026
Downloads
not available
Author
monotykamary
License
unknown
Types
extension
Size
2.6 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

🖼️ pi-warp-kitty-images

Kitty graphics protocol for Warp terminal in pi

Enable images, true color, and hyperlinks in Warp's TUI.

pi extension license

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-images

Or 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