Repolode
Submit
jarrodwatts

jarrodwatts/claude-image-view

A Claude Code mod that shows thumbnails of pasted images above the prompt instead of bare [Image #n] tags.

View on GitHub
Stars
240
Forks
21
Open issues
0
Last commit
8 days ago

What is it?

Claude Image View is a mod for Claude Code. When you paste an image into the prompt, Claude Code normally only inserts a text tag such as [Image #1]. This mod reads the prompt box and draws a row of thumbnails above the input, so you can see which picture each tag refers to.

Thumbnails keep their aspect ratio and shrink to fit the space above the prompt; extra images collapse into a +N counter. In Ghostty and kitty, Claude Code draws real pictures from the cached file. In other terminals, the mod downsamples the image and renders it with colored half blocks. Non-PNG pastes are converted with sips on macOS.

The mod is local-only and makes no network requests. It runs on macOS and Linux, and requires Claude Code v2.1.287 or later.

Key features

  • 01Shows thumbnails above the prompt as soon as an image is pasted.
  • 02Keeps each thumbnail's aspect ratio and fits the row on screen.
  • 03Displays real pictures in Ghostty and kitty, and half-block previews elsewhere.
  • 04Converts non-PNG pastes to PNG with sips on macOS.
  • 05Clears the thumbnail row when the prompt is sent or tags are removed.

Use cases

  • Working with several screenshots in one Claude Code prompt and keeping track of which tag is which.
  • Sharing UI mockups or photos with Claude Code from a terminal session.
  • Checking pasted images visually before sending a prompt.

Quick start

  1. 1

    Inside Claude Code, add the marketplace

    /plugin marketplace add jarrodwatts/claude-image-view
  2. 2

    Install the plugin

    /plugin install image-view
  3. 3

    Reload plugins

    /reload-plugins

Things to know

  • Requires Claude Code v2.1.287 or later.
  • Full-resolution thumbnails only in Ghostty or kitty; other terminals get lower-resolution half-block thumbnails.
  • Windows support is less tested and only previews PNG pastes.

Topics

#claude-code#terminal#cli#image-preview#developer-tools#plugin

FAQ

What is claude-image-view?
A Claude Code mod that shows thumbnails of pasted images above the prompt instead of bare [Image #n] tags. Claude Image View is a mod for Claude Code. When you paste an image into the prompt, Claude Code normally only inserts a text tag such as [Image #1]. This mod reads the prompt box and draws a row of thumbnails above the input, so you can see which picture each tag refers to.
Is claude-image-view free to use? What license does it have?
claude-image-view is open source under the MIT license. Check the license terms before using it in commercial products.
Is claude-image-view still maintained?
Actively maintained. The last commit to claude-image-view was on Oct 12, 2026.
What can I use claude-image-view for?
Working with several screenshots in one Claude Code prompt and keeping track of which tag is which. Sharing UI mockups or photos with Claude Code from a terminal session. Checking pasted images visually before sending a prompt.
How do I install claude-image-view?
Inside Claude Code, add the marketplace: /plugin marketplace add jarrodwatts/claude-image-view Install the plugin: /plugin install image-view Reload plugins: /reload-plugins
Where can I get claude-image-view?
The source code and installation instructions are on GitHub: https://github.com/jarrodwatts/claude-image-view

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects