Skip to content

Repository files navigation

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

Your agents can now iterate on frontend designs until they're flawless.


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


See it in action:

demo.mp4

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


Usage

For security, you need to connect the agent once on every startup.

  1. Start the WebSocket daemon:
peeked start
> Successfully started server.
  1. Connect your browser:

  1. 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 has been approved on the Chrome Web Store!

  1. Install the CLI
npm i -g peeked
  1. Install the Skill

For Claude Code:

/plugin marketplace add puffinsoft/peek-cli
/plugin install view-browser-tab@peek-cli

For Codex:

codex plugin marketplace add puffinsoft/peek-cli
codex plugin add view-browser-tab@peek-cli

Examples


⚠️ Is this safe?

Yes, 100%. It is impossible for the agent to do anything but take a screenshot.

This is because the agent sends screenshot requests to the extension through a WebSocket server.

It never accesses the browser and cannot inject any scripts / perform any actions.

We invite you to take a look at the extension source code for added peace of mind.


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

About

Let coding agents see your browser.

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages