GitHub - puffinsoft/peek-cli: Let coding agents see your browser. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Uh oh!
There was an error while loading. Please reload this page.
puffinsoft
peek-cli
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star<br>36
master
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>49 Commits<br>49 Commits
.claude-plugin
.claude-plugin
.codex-plugin
.codex-plugin
.github/workflows
.github/workflows
assets
assets
skills/view-browser-tab
skills/view-browser-tab
src
src
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
plugin.json
plugin.json
privacy.md
privacy.md
View all files
Repository files navigation
peek-cli allows agents to capture a screenshot of any open tab in your browser.
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:
Successfully started server.">peeked start<br>> Successfully started server.
Connect your browser:
You're good to go!
[ 'http://localhost:3000/' ]
peeked at http://localhost:3000 # capture screenshot<br>> Image saved to: /var/.../peek_cli/images/dd999ee0.jpg">peeked list # view available tabs<br>> [ 'http://localhost:3000/' ]
peeked at http://localhost:3000 # capture screenshot<br>> 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<br>/plugin install view-browser-tab@peek-cli
For Codex:
codex plugin marketplace add puffinsoft/peek-cli<br>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
Readme
License
MIT license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Custom properties
Stars
36<br>stars
Watchers
watching
Forks
fork
Report repository
Releases
v0.2.0
Latest
Jul 3, 2026
+ 1 release
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
TypeScript<br>77.9%
JavaScript<br>19.6%
CSS<br>2.5%
You can’t perform that action at this time.