show-image

Community

View images inline in Kitty terminal

Authorarchibate
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Many terminal users, especially over SSH, cannot easily view high-resolution images or plotting output inline; this Skill provides a reliable way to display saved plots and images directly inside a Kitty terminal without an X display.

Core Features & Use Cases

  • Kitty image protocol integration: Uses Kitty remote control and kitty +kitten icat to render images in a dedicated pane.
  • Persistent image server pane: Launches or reuses a separate Kitty pane running a small Unix-socket server so images can be pushed repeatedly without disrupting the main TUI.
  • Fallbacks and transformations: Falls back to timg when Kitty is unavailable and optionally inverts colors using ImageMagick convert for visibility adjustments.
  • Use Case: After running a script that saves a plot, send the saved file path to the viewer to inspect results inline without leaving the terminal workflow.

Quick Start

Run scripts/show_image.py /path/to/image.png to open or reuse a Kitty image pane and display the specified image.

Dependency Matrix

Required Modules

uvkittytimgconvert

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: show-image
Download link: https://github.com/archibate/archibate-skills/archive/main.zip#show-image

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.