puffinsoft/peek-cli
Let coding agents see your browser. Contribute to puffinsoft/peek-cli development by creating an account on GitHub.
105 stars · 5 forks · 0 watchers
README
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.
Start the WebSocket daemon:
peeked start
Successfully started server.
Connect your browser:
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
Install the Chrome Extension.
🎉 the extension has been approved on the Chrome Web Store!
Install the CLI
npm i -g peeked
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.