peek-cli allows agents to capture a screenshot of any open tab in your browser.

Works with Claude Code, Codex, Copilot and many more...

It works by using a browser extension to stream screenshots over WebSockets.

Usage

You only need to do steps 1 & 2 once on startup.

1. Start the WebSocket daemon:

peeked start
> Successfully started server.

2. Connect your browser:

3. You're good to go!

peeked list # view available tabs
> [ 'http://localhost:3000/' ]

peeked at http://localhost:3000 # capture screenshot
> Image saved to: /var/.../peek_cli/images/dd999ee0.jpg

Installation

1. Install the Chrome Extension.

^{the extension is in the process of approval; manual installation is needed for now.}

2. Install the CLI

3. Install the Skill

For Claude Code & Copilot:

/plugin marketplace add puffinsoft/peek-cli

For Codex:

codex plugin marketplace add puffinsoft/peek-cli

Examples

peek-cli is open source software, licensed under the MIT license.