Claude Code Paste Preview

paste-preview See what you paste. Circle what matters. English | 繁體中文 | 简体中文 | 日本語 | 한국어

Install

At the prompt of a Claude Code session in a terminal:

/plugin install paste-preview --marketplace alan890104/claude-code-paste-preview

Answer y to add the marketplace, then pick a scope (user scope loads it in every session). It runs at once, with no restart.

https://github.com/user-attachments/assets/7098c51e-ce1e-43ad-9fe3-5189ef1fdb88

A Claude Code mod for the images you paste. In the terminal a pasted image is just [Image #1], and three pastes later you can't tell which is which. With this mod:

• You see what you pasted. Every [Image #N] in the prompt box shows as a thumbnail above the prompt, and sent prompts show theirs in the transcript, each labelled Image #N.
• You can mark it up before sending. An editor opens the moment you paste: pen, ellipse, box, arrow, text, crop, rotate, seven colours, undo. Press Enter when done, or Esc to keep the picture as pasted.
• Claude gets the marked-up version. At Enter the original paste is left out of the message and Claude is pointed at the edited picture.
• Full screen works on macOS. There the editor is a native floating panel that sits over a full-screen terminal the way Spotlight does: no Space switch, and the keys return to the prompt when it closes. It waits ready in the background, so it appears the instant you paste (about 100 MB while it waits; after 20 minutes unused it quits, and comes back as you type). On Linux and Windows it opens as a browser app window.

Requirements

• macOS, Linux or Windows
• Claude Code 2.1.291 or newer (mods are an early-access feature)
• For thumbnails, a terminal with the kitty graphics protocol, such as Ghostty or kitty. Other terminals (Windows Terminal among them) show Image #N in place of the picture, with its Edit button.

	The editor	The clipboard, only when Claude Code's own copy of a paste can't be found
macOS	The Xcode Command Line Tools (xcode-select --install). The panel is compiled once, on first use, in a few seconds. Without them the editor opens as a Google Chrome app window instead, which needs Node.js and Chrome.	Optional: pngpaste (brew install pngpaste)
Linux	Node.js 18 or newer (node on PATH). The editor opens as an app window of Chrome, Chromium, Edge or Brave when one is installed, else in the default browser (xdg-open).	wl-clipboard (Wayland) or xclip (X11), the tools Claude Code itself pastes images with
Windows	Node.js 18 or newer (node.exe on PATH). The editor opens as a Microsoft Edge app window (Chrome where Edge is missing), else in the default browser.	Nothing: PowerShell, built in

Where something is missing the mod says so in a toast: which tool, and the thumbnail still shows.

Use

Paste an image as usual: Ctrl+V, or Alt+V on Windows and under WSL, the keys Claude Code itself binds to pasting an image (chat:imagePaste). The editor opens on its own.