Why does this skill use a separate tmux pane?

Viewing images directly in the main terminal can clutter the conversation history with character-based rendering, making it hard to read code. A separate pane keeps the workspace organized.

What happens if I switch panes while the image is loading?

The skill captures the specific $TMUX_PANE ID before execution, ensuring the command is sent to the correct split even if you move your cursor elsewhere.

Can I control the image rendering quality?

Yes, the skill supports chafa options for true color, 256 colors, and specific symbols like 'block' to optimize for your terminal's capabilities.

Do I need to have chafa installed?

Yes, this skill relies on the chafa utility to render images using terminal symbols and colors.

Terminal Image Viewer

Name: Terminal Image Viewer
Author: mshuffett

bymshuffett

0•

Productivity & Workflow

Displays high-quality images directly in terminal windows using chafa and smart tmux pane management to keep conversations clean.

This skill empowers Claude to render images within a terminal environment by leveraging the chafa utility and tmux multiplexing. It implements a strict protocol that always opens images in a dedicated side-pane, preventing visual clutter from disrupting the main conversation history. By capturing specific pane IDs before execution, the skill ensures that images are displayed reliably even if the user switches focus, making it ideal for developers who need to preview generated assets, UI mockups, or data visualizations without leaving their CLI workflow.

Key Features

01Streamlined workflow for inspecting generated assets immediately after creation

02High-performance rendering with chafa support for true color and block symbols

03Customizable split orientations for horizontal or vertical previews

04Automated tmux pane management for non-intrusive image viewing

05Stable pane targeting to prevent command redirection errors during context switches

060 GitHub stars

Use Cases

01Visualizing output from image processing scripts or data visualization pipelines

02Previewing AI-generated UI components or logos during the design phase

03Inspecting local image assets and icons directly within a terminal-based IDE

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mshuffett/dotfiles terminal-images

For use in Claude.ai and ChatGPT

Download Skill