Let AI agents see your UI — point at elements, annotate, and get instant visual context for AI-powered code editing.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"peek-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Peek Point at your UI. Your AI agent sees it. <p align="center"> <img src="peek-demo.gif" alt="Peek demo: point at a UI element, agent sees it" width="720"> </p> ## Why AI coding agents can edit code, but they can't see your page. You end up describing layouts in words, copy-pasting HTML, or dragging screenshots into chat. Peek fixes this. Your AI agent can screenshot any local page on its own. You can also point at specific elements with a bookmarklet, and the agent gets the screenshot plus element data (selectors, styles, bounding boxes). ## Contents - [Quick Start](#quick-start) - [Claude Code (CLI or VS Code)](#claude-code-cli-or-vs-code) - [Upgrading](#upgrading) - [Other MCP clients (experimental)](#other-mcp-clients-experimental) - [Tell your agent your dev port](#recommended-tell-your-agent-your-dev-port) - [Use it](#use-it) - [Supported URLs](#supported-urls) - [MCP Tools](#mcp-tools) - [How It Works](#how-it-works) - [Troubleshooting](#troubleshooting) - [Limitations](#limitations) - [CLI](#cli) ## Quick Start ### Claude Code (CLI or VS Code) ```bash # 1. Install uv (one-time, manages Python for you) brew install uv # or: curl -LsSf https://astral.sh/uv/install.sh | sh # 2. Install peek (uv auto-downloads a compatible Python) uv tool install peek-mcp # 3. One-shot setup peek setup ``` `peek setup` is one-shot: installs Playwright Chromium, registers Peek as an MCP server in Claude Code (user scope, all projects), drops the bookmarklet page at `~/.peek/bookmarklet.html` and opens it in your browser. Drag the blue button to your bookmark bar and you're done; the command exits on its own. Nothing to keep running. From then on: **open Claude Code and use it normally.** It auto-launches Peek in the background whenever the agent uses a Peek tool. > Using pip directly? `pip install peek-mcp` works too, but requires Python 3.10+ already installed. `uv tool install` avoids the version-mismatch headache. ### Upgrading ```bash uv tool …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.