claude-image-view README

The project's README from github.com/jarrodwatts/claude-image-view. As one markdown file: README.md.

Claude Image View

A Claude Code mod that shows the images you paste, so you see thumbnails above your prompt instead of bare [Image #1] tags.

License Stars

Claude Image View in action

Install

Inside Claude Code, run:

/plugin marketplace add jarrodwatts/claude-image-view
/plugin install image-view
/reload-plugins

That's it. Paste an image into the prompt and its thumbnail appears above the input.

Prefer the terminal? 
claude plugin marketplace add jarrodwatts/claude-image-view
claude plugin install image-view@claude-image-view

Then run /reload-plugins inside a session, or start a new one.

What You See

Paste one or more images and a row of thumbnails sits above the prompt, each labelled with the number of its tag:

╭────────────────────────╮ ╭────────────╮
│                        │ │            │
│      (screenshot)      │ │  (photo)   │
│                        │ │            │
│           #1           │ │     #2     │
╰────────────────────────╯ ╰────────────╯
❯ why is the header misaligned here [Image #1] vs [Image #2]

How It Works

Claude Code saves every pasted image to a cache folder for the session, as <tmp>/<project>/<session>/images/<n>.png, and puts an [Image #n] tag in the prompt. Claude Image View is a mod:

  1. Every 200ms it reads the prompt box and looks for [Image #n] tags. It checks on a timer because pasting an image doesn't raise an edit event.
  2. For each tag it finds the cached PNG and reads its size from the PNG header.
  3. It draws the thumbnails in the band above the prompt with Claude Code's Image element. The terminal reads the file itself, so the image data never passes through the mod.

Security

Claude Image View is local-only. It makes no network requests and writes no files. It reads the prompt box, lists Claude Code's temp folder to find the current session's image cache, and reads the first bytes of each pasted image. If CLAUDE_CODE_TMPDIR isn't set, it runs id -u once to find the default temp folder.

Run claude plugin validate on the repo to see every event it hooks and every call it makes.

Requirements

Other terminals show [Image #n] in each tile instead of the picture. The Claude Desktop app already previews pasted images, so the mod draws nothing there.

Troubleshooting

Nothing appears when I paste. Run /plugin and check the dim line under the tabs lists image-view as an active mod. If it isn't listed, run /reload-plugins.

The tile says "no preview". The mod couldn't find the cached file. Claude Code may have moved where it stores pasted images. Please open an issue with your Claude Code version.

The tile shows [Image #1] text instead of the picture. Your terminal doesn't support the kitty graphics protocol. See Requirements.

The tile shows [Image #1] text in agent view or a background session, even in Ghostty or kitty. Claude Code turns terminal images off for background sessions. If you attach from a terminal with the kitty graphics protocol, turn them back on in the env block of ~/.claude/settings.json, then start a new session:

"env": { "CLAUDE_CODE_FORCE_TERMINAL_IMAGES": "1" }

Development

git clone https://github.com/jarrodwatts/claude-image-view
cd claude-image-view

# Load it for one session without installing
claude --plugin-dir .

# Check it and run the tests
claude plugin validate .
claude plugin test .

Claude Code writes the API types into .claude-plugin/types/ the first time it loads the mod, and tsc -p . type-checks it from then on.

License

MIT. See LICENSE.

Star History

Star History Chart

claude-image-view (jarrodwatts/claude-image-view)

Searching Database…

240 ·GitHub
Claude-image-view
Что это?Claude Image View — это мод для Claude Code, который показывает миниатюры изображений, вставленных в промпт, вместо голых текстовых тегов [Image #1].
Это отдельное приложение или плагин для Claude Code?Это плагин (мод), который загружается внутри существующей терминальной сессии Claude Code, а не отдельное приложение; Claude Code даже генерирует для мода его API-типы при первой загрузке.
Как его запустить?Установите его изнутри Claude Code, затем просто вставьте изображение в промпт — его миниатюра автоматически появится над полем ввода; если ничего не отображается, выполните /reload-plugins или начните новую сессию.
Что нужно, чтобы всё это реально работало?Нужен Claude Code v2.1.287 или новее с поддержкой модов, запущенный на macOS или Linux, внутри терминала с поддержкой графического протокола kitty, например Ghostty или kitty.
Предпросмотр миниатюр работает всегда?Нет: терминалы без графического протокола kitty покажут лишь исходный текст [Image #n] вместо картинки, а Claude Code к тому же отключает изображения в терминале для фоновых сессий и режима просмотра агентов, если не включить их обратно в settings.json.
Этот мод отправляет мои вставленные изображения куда-то?Нет, он работает только локально: не делает сетевых запросов и не пишет файлов, а лишь читает поле промпта и PNG-файлы, которые Claude Code уже закэшировал локально для сессии.
Он что-то делает внутри приложения Claude Desktop?Нет, Claude Desktop и сам показывает превью вставленных изображений, так что мод там ничего не рисует.
Как именно он находит и рисует изображения?Каждые 200 мс он сканирует поле промпта на теги [Image #n], сопоставляет каждый тег с PNG, закэшированным Claude Code для этой сессии, читает размер из заголовка PNG и рисует изображение над промптом с помощью элемента Image из Claude Code.
Что означает плитка «no preview»?Это значит, что мод не нашёл закэшированный PNG для этого тега — обычно потому, что Claude Code изменил место хранения вставленных изображений; в качестве решения предлагается создать issue, указав вашу версию Claude Code.
What are similar projects?gyotaku, claude-db, flyingmouse-format, revpdf-release, jevmem, lazy-frames, agent-router, vibe-aso
Which topics is it in?ghostty, terminal-emulators, screenshot, claude-code-plugin, image, cli-tool, image-processing, offline, utility, local-first, plugin, claude
Creator
jarrodwatts
Size
0.4 MB
Stars
240
Updated
CommitOct 12Releasev0.2.0Oct 12
Age
16d
Commits · 90 Days