Display an image in the terminal (Kitty graphics protocol). Use this to show images, pictures, graphs, and generated images directly in the terminal.
How this skill is triggered — by the user, by Claude, or both
Slash command
/kitty-cli-display-image:kitty-cli-display-imageThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
I display an image inside a fixed Kitty overlay window. The image is sized to
I display an image inside a fixed Kitty overlay window. The image is sized to fill the terminal with a 2-cell border on its long axis and is centered on the short axis, so wide images get vertical centering and tall images get horizontal centering. Because the image lives in an overlay window it stays fixed and does not scroll with text underneath.
${CLAUDE_SKILL_DIR}/scripts/display.sh "<path_to_image>"
kitten icat handles the rendering, so any format it supports (PNG, JPEG,
GIF, BMP, TIFF, WebP, …) works without conversion.
From inside the overlay, the user can press any key. From outside (e.g., from this agent):
${CLAUDE_SKILL_DIR}/scripts/display.sh --dismiss
--dismisskitty.conf:
allow_remote_control yes
listen_on unix:/tmp/kitty-{kitty_pid}
then restart kitty. The script reads KITTY_LISTEN_ON from the environment
to talk to the running kitty instance.kitten (ships with kitty), plus standard POSIX tools (bash, tput,
awk, grep, file). On macOS sips is used for image dimensions; on
other systems file is the fallback. No Python or Node required.IMAGE_DISPLAY_NO_SIPS — on macOS, sips is used by default to read image
dimensions. Set this variable to any non-empty value to skip sips and fall
back to parsing file -b output. Useful if sips mis-handles a particular
format on your system, or for testing the non-macOS code path.If the script exits non-zero, check stderr. Common issues:
KITTY_LISTEN_ON is not set — kitty remote control isn't configured (see
Requirements above)File not found — check the image pathcould not read image dimensions — the image format isn't recognized by
sips/file; convert to PNG or JPEG and retryCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub rezrov/claude-marketplace --plugin kitty-cli-display-image