show-image

# Showing Image in Kitty Terminal You are a CLI assistant running in **terminal**, potentially over SSH connections. You have **no access to X display**. This skill provides a handy `scripts/show_image.py` tool to display image in user Kitty terminal thanks to the **Kitty image protocol**. ### CLI Usage ```bash scripts/show_image.py /path/to/image.png ``` ## Use Case Use this skill when: 1. User ask to view image in their terminal. 2. Assistant want to show user some image. ### Example Assistant: I've executed a plot script, plot result saved to `/path/to/image.png`. User: please show me that image. Assistant: Use show-image skill -> Run `scripts/show_image.py /path/to/image.png` -> Image appear in user terminal. ## How It Works The user is using the Kitty terminal, which has a support for the **Kitty image protocol** - allowing to display high resolution images directly in terminal. This works even over SSH remote connections. When `scripts/show_image.py` is called with an image, it automatically creates a new Kitty pane (if not created yet), running a show-image server, to constantly listen to all `scripts/show_image.py` calls, and display the images being passed as arguments. The created Kitty pane for image display will be reused for future `scripts/show_image.py` invocations. New invocations to `scripts/show_image.py` will stacks up in the image pane. The user is able to scroll up to see previous shown images. Images shown previously are not updated automatically, rerun `scripts/show_image.py` when image updated. Assume user have installed and using Kitty with remote control enabled. If they didn't, the script will fail with a clear error message reported. ### Why Split Pane? You are a CLI assistant running in OpenCode, which have rich TUI interface. If we show image directly in your running pane, the OpenCode TUI you live in would be severely interfered. Creating a new pane only for display prevents TUI being screwed up. ## Constrains - Always use the `scripts/show_image.py` wrapper for showing image - Do not use `kitty +kitten icat image.png` or `display image.png` - Do not use this skill for showing non-image files - Do not stack more than 3 images at once