
A Claude Code plugin that shows you the images you paste into the prompt. Claude Code turns a pasted or dragged image
into a bare [Image #1] tag; Image Peek draws a thumbnail of each one above the prompt, and a button that opens it full
size.
It is a mod: a plugin of function hooks that runs inside Claude Code (getting started with mods).
It was built for Warp, and works in any terminal with 24-bit color. macOS only: it scales
the images with sips and opens them with Quick Look.
/plugin marketplace add chicio/chicio-labs
/plugin install image-peek@chicio-labs
/reload-plugins
[Image #N] in the draft, in
the order they appear, sized to keep each picture's proportions and shrunk so the whole row fits. Delete a tag, or
send the prompt, and its tile goes.⤢ button, or focus the band (ctrl+x tab, or click) and press the image's number (1 to 9).
The image opens in Quick Look, brought in front of the terminal; Space or Esc closes it. The first time, macOS may
ask to let the terminal control System Events, which is what brings the panel forward.The thumbnail depends on what the terminal can show inside Claude Code:
Warp renders kitty images in ordinary command output, but not the Unicode placeholders Claude Code uses
(warpdotdev/warp#6210), and a plugin cannot send image escape
sequences of its own. When Warp supports them, setting CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1 switches Image Peek to
real pixels there too.
The thumbnails are written next to Claude Code's cached copy of each paste, in the session's temporary folder, and go with it.
Inspired by claude-image-view by Jarrod Watts, which shows real pixels in kitty and Ghostty. Image Peek's paste detection, cache lookup and tile layout are adapted from it under the MIT License, as is Image Peek; both notices are in LICENSE.
From the repository root:
claude plugin validate claude-plugins/image-peek
claude plugin test claude-plugins/image-peek
CI runs both on every push. tsc -p claude-plugins/image-peek type-checks the mod once a Claude Code session has
loaded it, since the engine writes the type declarations it extends at load time. Releases go through the
release-plugin.yml workflow, which bumps version in .claude-plugin/plugin.json, writes CHANGELOG.md and tags
image-peek--v<version>.