show-image

Display images in Kitty terminals via scripts/show_image.py.

Updated Aug 23, 2026

Search Tags:#image #cli #visualization #terminal #viewer #kitty

Ready to run

npx skills add https://github.com/BoChao1Zhang/dotfiles --skill show-image-bochao1zhang

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: show-image
Source: https://github.com/BoChao1Zhang/dotfiles/tree/main/dot_codex/skills/show-image
Command: npx skills add https://github.com/BoChao1Zhang/dotfiles --skill show-image-bochao1zhang

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill enables viewing images directly in a terminal by leveraging the Kitty image protocol, allowing plots and images to be inspected without leaving the CLI.

Core Features & Use Cases

Display images in Kitty terminals using the provided scripts/show_image.py wrapper, which serves images via a dedicated Kitty pane.
Falls back gracefully in non-Kitty environments using alternative image viewers, and supports inversion for contrast adjustments.
Use cases include showing plot results after generation, debugging image outputs, or sharing visual results in logs and reports.

Quick Start

Call scripts/show_image.py with the path to an image to display it in your Kitty terminal.

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 directly in a terminal session?▼

To display images in a terminal session, you can use the Kitty image protocol via a wrapper script that renders visual output inline. This allows you to inspect plots or image files without leaving the CLI.

Can I view images over a remote SSH connection?▼

Yes, you can view images over a remote SSH session by leveraging the Kitty image protocol. This enables inline visualization of plots and image files directly within your remote terminal environment.

What terminal do I need to use to show images inline?▼

You need a Kitty-enabled terminal to show images inline using the Kitty image protocol. The wrapper script specifically serves images through a dedicated Kitty pane for rendering.

Does this image viewer work in non-Kitty terminal environments?▼

Yes, the image viewer falls back gracefully in non-Kitty environments by using alternative image viewers. This ensures you can still display visual outputs even without native Kitty protocol support.

How can I adjust contrast for images shown in the terminal?▼

You can adjust contrast for images shown in the terminal by using the inversion feature. This allows you to apply contrast adjustments to the visual output rendered via the wrapper script.

What's the best way to debug image outputs without leaving the CLI?▼

To debug image outputs without leaving the CLI, use a wrapper script that displays images via the Kitty image protocol. This enables inline visualization during data analysis, letting you inspect results immediately after generation.