alex2481kobe/claude-mods/tree/main/plugins/peek

Claude Code 플러그인으로, Claude가 생성하거나 찾은 이미지를 터미널에 직접 표시합니다. kitty와 Ghostty에서는 실제 픽셀로, 다른 터미널에서는 컬러 블록으로 미리 보기를 제공합니다.
alex2481kobe/claude-mods/tree/main/plugins/peek

peek은 Claude의 도구 호출 바 바로 아래에 이미지를 임베드하여 브라우저나 휴대폰을 열 필요가 없습니다. Ghostty 또는 kitty에서는 kitty 그래픽 프로토콜을 통해 실제 이미지를 렌더링하고(먼저 이미지를 PNG로 $TMPDIR/peek/에 복사), 다른 터미널(Apple Terminal, iTerm2, WezTerm, VS Code Terminal, tmux)에서는 반 블록 문자 ▀와 자체 매핑된 256색 팔레트 및 가벼운 디더링을 사용하여 약 160x96 픽셀의 컬러 블록 미리 보기를 생성합니다. Claude Code Desktop 및 모바일 앱은 도구 모음만 표시합니다. 요구 사항은 mod를 지원하는 Claude Code(2.1.287에서 테스트됨)와 macOS(내장 sips를 사용하여 이미지 변환)입니다. 설치는 /plugin marketplace add alex2481kobe/claude-mods 및 /plugin install peek@claude-mods를 통해 이루어집니다. 자연어로 Claude에게 show 도구를 호출하도록 요청하거나, /peek ~/Desktop/screenshot.png를 사용하여 수동으로 이미지를 표시할 수 있습니다. 구현에는 show 도구를 등록하는 $.tool.register, 시스템 프롬프트를 보완하는 prompt.compose 훅, 도구 모음 아래에 그리는 ui.render 훅이 포함되어 있으며, CIE Lab 최근접 색상과 1/4 강도 Floyd-Steinberg 디더링을 사용하여 블록 미리 보기를 생성합니다. 제한 사항으로는 블록 미리 보기가 거칠다는 점, 평평한 영역에 약간의 디더링 텍스처가 나타날 수 있다는 점, tmux에서는 항상 블록 미리 보기가 사용된다는 점, macOS만 지원한다는 점, 표시된 각 이미지가 $TMPDIR/peek/에 PNG 복사본을 남긴다는 점이 있습니다.
먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.
claude plugin marketplace add alex2481kobe/claude-mods claude plugin install peek@claude-mods
Images in the terminal. When Claude makes, downloads, captures or finds an image you should look at, it shows it to you inline, under its tool call, without you opening a browser or your phone.
In Ghostty or kitty it is the real picture:

In other terminals it is a colored-block preview:

| Terminal | What peek draws | | --- | --- | | Ghostty, kitty | The real picture, in pixels | | Apple Terminal, iTerm2, WezTerm, VS Code's terminal, anything inside tmux | A colored-block preview, about 160x96 pixels at most | | Claude Code Desktop, the mobile app | Nothing: the tool row only |
The reason is what a terminal can draw. Every terminal draws text: a grid of cells, each one character with a text and a background color. A real picture needs the terminal to implement a graphics protocol, a way for a program to hand it pixels. Claude Code draws a mod's pictures through the kitty graphics protocol, which kitty and Ghostty implement. Apple Terminal implements none, and Claude Code does not promise pictures in the others.
Elsewhere peek fakes the picture with text: each cell is an upper half block
▀ whose text color paints one pixel and whose background paints the one
below it, so a cell holds two pixels. Claude Code draws these in the 256-color
palette even where the terminal has more, so peek picks the palette colors
itself, by how close they look, and lightly dithers between them.
sips, which ships with it/plugin marketplace add alex2481kobe/claude-mods
/plugin install peek@claude-mods
Ask for an image the way you would anyway ("show me the screenshot", "make a
chart of this and let me see it"). Claude calls the show tool on its own.
You can also show one yourself:
/peek ~/Desktop/screenshot.png
Any format macOS opens works: PNG, JPEG, HEIC, GIF, TIFF, BMP.
$.tool.register adds the show tool (mcp__peek__show). Claude Code may
defer a plugin's tool, which hides its description until it is loaded, so a
prompt.compose hook also adds a short section to the system prompt: to let
you see an image, call show. Reading an image shows it only to Claude.TERM_PROGRAM=ghostty, or KITTY_WINDOW_ID set) the
picture is an Image element over a PNG copy of the image in
$TMPDIR/peek/. The terminal reads that file itself at every redraw, and
Claude Code refuses a file on a network or device path, so the copy keeps the
picture working when the original moves or lives on a mounted volume.sips scales the image and writes an uncompressed BMP, which peek
decodes, fits to the 256-color palette (nearest in CIE Lab, then
Floyd-Steinberg at a quarter strength) and draws as a Raster of half
blocks.ui.render hook on the tool's row, and on /peek's output row, draws the
picture under it.The dither strength was measured, not guessed: on live captures of a 256-color terminal, a quarter strength cut the error you see at a glance by 8-22% against no dithering, without the checkerboard that stronger dithering leaves in this palette.
$TMPDIR/peek/,
which macOS clears with the rest of the temporary folder.claude plugin validate plugins/peek
claude plugin test plugins/peek
claude --plugin-dir plugins/peek
내 프로젝트인가요? 이 배지를 README나 웹사이트에 넣으면 이 페이지로 연결됩니다.