skills.rest
archibate
archibateCOMMUNITY
Explore all skills by this author →
Website𝕏@archibateGitHub

show-image

Display images in Kitty terminal panes via Unix socket server.

6|Updated Feb 25, 2026
Search Tags:#images#terminal#ssh#imagemagick#kitty#image-display#icat
One-click install
npx skills add https://github.com/archibate/archibate-skills --skill show-image
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: show-image
Source: https://github.com/archibate/archibate-skills/tree/main/skills/show-image
Command: npx skills add https://github.com/archibate/archibate-skills --skill show-image

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires uv, kitty, timg, convert, and includes scripts (resource) components.

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.

Frequently Asked Questions about show-image

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I display images inline in a Kitty terminal over SSH?▼

To display images inline in a Kitty terminal over SSH, use a script that leverages the Kitty image protocol and kitty +kitten icat to render graphics in a dedicated pane without needing an X display.

Can I view saved plots in a terminal session without disrupting my TUI workflow?▼

Yes, you can view saved plots without disrupting your TUI workflow by launching a persistent image server pane via a Unix domain socket, allowing you to push images repeatedly to a separate Kitty pane.

What is the best way to view high-resolution images in an SSH session when Kitty is unavailable?▼

The best fallback way to view high-resolution images when Kitty is unavailable is using timg, which acts as a secondary renderer to display images directly in the terminal.

Does the Kitty image protocol support color inversion for terminal visibility adjustments?▼

Yes, the Kitty image protocol workflow supports color inversion for visibility adjustments by optionally processing the image through ImageMagick convert before rendering it in the terminal pane.

How do I programmatically show produced graphics in a local Kitty terminal session?▼

You programmatically show produced graphics in a local Kitty session by passing the saved file path to the viewer script, which opens or reuses an image pane to render the output inline.

Related Skills

Explore More Software Engineering Skills→
a322655a322655
1

ai-comm

Route messages between AI CLIs in separate Kitty windows.

Community
Intermediate
yahav123147yahav123147

pptx

Extract, edit, and create PowerPoint .pptx presentations via XML workflows.

Community
Advanced
Citrus-bitCitrus-bit
135

image-generation

Generate images from JSON prompts and reference images via the Gemini API.

Community
Intermediate
dotBeepsdotBeeps

kitty-gif-renderer

Render animated GIFs inline in terminal panels via the Kitty graphics protocol.

Community
Intermediate