paste-preview plugin
Claude Code plugin for pasted images: thumbnails above the prompt and a markup editor before sending.
- 63 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Starts a local editor and writes image edits to a temporary folder.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/paste-previewDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Starts a local editor and writes image edits to a temporary folder.
This is third-party code. Review the repository files before installing.
What it does
paste-preview fixes a terminal annoyance: a pasted image appears as `[Image #1]` and after three pastes you cannot tell which is which. The plugin shows each picture as a thumbnail above the prompt and labels it with its number in sent messages. Right after a paste an editor opens with a pen, ellipse, box, arrow, text, crop, rotate, seven colors and undo. On Enter Claude receives the edited version instead of the original. On macOS the editor is a native floating panel over a full-screen terminal, while on Linux and Windows it opens as a browser window. The interface comes in five languages.
Who it is for. Claude Code terminal users who paste screenshots often and want to mark what matters before sending.
Good fit when
- Several error screenshots are pasted into a message and you must see which is which.
- An arrow marks the interface element being discussed on a screenshot.
- An unneeded part of an image is cropped before it goes to the agent.
- A screenshot with a confidential fragment is covered with a box before sending.
Not a fit when
- Claude Code older than 2.1.291 is in use.
- Thumbnails are wanted inside tmux or GNU screen, where Claude Code draws no pictures.
- Images are edited outside a terminal, for example in Claude Desktop.
Example request
Paste a screenshot, mark with an arrow the button where the form fails and describe what should happen on click.Limitations
Claude Code 2.1.291 or newer is required, as mods are an early-access feature. Thumbnails work in terminals with the kitty graphics protocol such as Ghostty and kitty, while others show a number and an Edit button. On macOS Xcode Command Line Tools are needed, since the panel is compiled on first use, otherwise a Chrome window opens, which needs Node.js and the browser. A plugin cannot swap an image in a message: it drops the original and adds a note pointing at the edit. Thumbnails in the transcript cover the current session only.
How to disable. Disable or remove the plugin with Claude Code plugin manager commands. Edited pictures sit in a temporary `paste-preview` folder and folders older than a week are cleaned automatically.
FAQ
How to reopen the editor?
Press Edit under the thumbnail above the prompt, or `ctrl+x tab` and the picture number.
What do the editor keys do?
`P`, `O`, `B`, `A`, `T` pick pen, ellipse, box, arrow and text, `C` crops, `R` rotates, `1`–`7` set the color, Enter finishes and Esc cancels, keeping the original picture.
What is needed on Linux?
Node.js 18 or newer, and for the clipboard `wl-clipboard` on Wayland or `xclip` on X11. The editor opens in a Chrome, Chromium, Edge or Brave window, else in the default browser.
Where are edited files written?
On macOS to `/private/tmp/paste-preview/<session>/<number>.png`, on Linux to `/tmp/paste-preview-<uid>/`, on Windows to `%TEMP%\paste-preview\`.
Is there a Russian interface?
No: the editor and labels come in English, Traditional and Simplified Chinese, Japanese and Korean, chosen by the system language.
Discussion
No questions or reviews yet.
Related
PluginsPasted images appear as thumbnails above the prompt, not as bare Image tags, so they are hard to mix up.
A screenshot from the clipboard reaches Claude Code, Codex and Cursor on macOS, Windows, over SSH and in WSL2, with no config
Two plugins change how Claude Code output looks: replies in the glamour dark style and tool calls as compact one-liners.
A marketplace of 70 small Claude Code plugins with panes: notes, a task board, a context meter, utilities and a Git change viewer
A plugin that renders Claude Code answers as a typeset picture via Typst: tables, math, charts and diagrams in the terminal.
A Claude Code plugin that catches your corrections in chat and, after review, writes them into CLAUDE.md and AGENTS.md
README in short
A Claude Code mod that adds thumbnails for pasted images and a markup editor, rewrites the reference to the edit in the message and supports macOS, Linux and Windows.