peeked

peeked command [arguments]

`peeked` is the command-line component of peek-cli. It lets AI coding agents (such as Claude Code, Codex, and others) obtain live screenshots of open browser tabs.The tool consists of a local WebSocket server started by `peeked start`. A companion Chrome extension connects to the server and forwards screenshots on demand. Agents issue commands through the CLI (or via agent skills/plugins) to list tabs and request captures.Screenshots are delivered as base64 and written locally by the CLI; the agent never directly accesses the browser or injects code.Installation:

$ npm i -g peeked

start

Start the local WebSocket server (on port 7336) that receives screenshot requests and streams to the browser extension. Cleans previous images on start.

List all tracked open tab URLs reported by the connected browser extension.

Request a screenshot of the specified URL from the connected browser tab. Saves the JPEG to a temporary directory (e.g. `$TMPDIR/peek_cli/images/`).

Report whether the server is running and whether a browser extension is connected.

Stop the running WebSocket server process.

Requires the official Peek CLI Chrome extension; without it the server has no tabs to report or capture from.The server binds only to localhost. You must explicitly start it on every machine/session before use.Screenshots are written to a per-user temp directory and are not automatically cleaned except on `start`.Error messages may refer to outdated command names in some versions (e.g. "peeked begin").Only provides read-only screenshot capability; no navigation, input, or page manipulation is possible.

claude(1), codex(1)

Source code