---
title: "peek"
url: "https://claudemods.dev/ko/builds/peek-59c528"
source: "https://github.com/alex2481kobe/claude-mods/tree/main/plugins/peek"
source_type: "github"
repo: "https://github.com/alex2481kobe/claude-mods/tree/main/plugins/peek"
author: "alex2481kobe"
author_handle: "alex2481kobe"
stars: 3
category: "대시보드 및 HUD"
categories: ["hud"]
tags: ["ghostty", "hooks", "images", "kitty", "macos", "terminal", "tool"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add alex2481kobe/claude-mods\nclaude plugin install peek@claude-mods"
added: "2026-10-05T01:58:23.901Z"
updated: "2026-10-28T09:20:42Z"
locale: "ko"
content_locale: "ko"
---

# peek

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

## Description

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 복사본을 남긴다는 점이 있습니다.

## Install

```
claude plugin marketplace add alex2481kobe/claude-mods
claude plugin install peek@claude-mods
```

## Original README

# peek

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:

![Claude showing an image in Ghostty as a real picture](media/ghostty-picture.png)

In other terminals it is a colored-block preview:

![Claude showing an image in a 256-color terminal as a colored-block preview](media/blocky-preview.png)

## What you see depends on your terminal

| 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.

## Requirements

- Claude Code with mods (tested on 2.1.287)
- macOS: images are read and converted with `sips`, which ships with it

## Install

```
/plugin marketplace add alex2481kobe/claude-mods
/plugin install peek@claude-mods
```

## Use

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.

## How it works

- `$.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.
- In kitty or Ghostty (`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.
- Elsewhere `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.
- A `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.

## Limits

- The block preview is coarse: fine text in a screenshot will not be readable.
- Flat areas in charts and app screenshots get a faint dither pattern.
- Pictures are drawn in the terminal only; the desktop and mobile apps show
  the tool row without the image.
- In tmux the block preview is used even inside Ghostty or kitty.
- In kitty and Ghostty each shown image leaves a PNG copy in `$TMPDIR/peek/`,
  which macOS clears with the rest of the temporary folder.
- macOS only.
- Tried live in Apple Terminal (macOS 15), in a 256-color tmux pane, and in
  Ghostty 1.3.1: PNG, JPEG, HEIC, a 6000x4000 PNG (under half a second), a
  transparent PNG, and 20 images in one session.

## Develop

```sh
claude plugin validate plugins/peek
claude plugin test plugins/peek
claude --plugin-dir plugins/peek
```
