Peek

Peek lets Claude take screenshots and short recordings of your local app and hand you a link you can open on your phone.

It is built for the exact moment when Claude changed a UI and you want to see it, not read about it.

Install

Recommended:

npm install -g @adikuma/peek
peek install

This installs Peek globally and registers it in Claude.

Then restart Claude Code or run /reload-plugins.

Local repo setup:

pnpm install
pnpm build
pnpm setup

Remove it from Claude:

peek uninstall

The first install may download Chromium and cloudflared. After that they are cached.

What it does

Peek gives Claude three tools:

• screenshot
• record
• list

Typical flow:

1. Claude opens your app URL in Chromium
2. Peek captures a screenshot or short video
3. Peek serves the file from your machine
4. Cloudflare gives it a temporary public URL
5. Claude sends you the preview and the link

When to use it

Use screenshot for static UI checks.

Use record when motion or interaction matters, like:

• toggles
• hover states
• modals
• navigation
• small flows

Important notes

• Files stay on your machine
• The public link is temporary
• Peek captures the supplied URL in Chromium
• It does not capture the native Tauri or Electron window
• For Tauri or Electron apps, Chromium can look different from the real app window
• The viewer also supports ?theme=dark and ?theme=light

Config

All env vars are optional.

| Env var | Default | What it does | |---|---|---| | PEEK_PORT | random | pin the local HTTP server port | | PEEK_VIEWPORT | phone | default viewport: phone or desktop | | PEEK_MAX_SECONDS | 15 | cap on record duration | | PEEK_DEV_URL | unset | prefer this host label in the viewer | | PEEK_SKIP_TUNNEL | 0 | skip Cloudflare and use local-only URLs | | PEEK_DEBUG | 0 | verbose logs to stderr |

Tests

pnpm test
pnpm test:tunnel
pnpm test:all

UI preview:

pnpm preview:ui