Skip to content
Back to search

peek-cli

MarketplaceWorks with Claude CodeGitHub

Let coding agents see your browser.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/puffinsoft--peek-cli/badge.svg)](/listings/puffinsoft--peek-cli)

HTML

<a href="/listings/puffinsoft--peek-cli"><img src="/api/listings/puffinsoft--peek-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install the [Chrome Extension](https://chromewebstore.google.com/detail/peek-cli/fekplnpejnpnfmgikkleldnncgickmbb).

<sup>馃帀 the extension has been approved on the Chrome Web Store!</sup>

2. Install the CLI

npm i -g peeked

3. 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

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json 路 Manifest 路 13 lines
  1. {
  2. "name": "peek-cli",
  3. "owner": {
  4. "name": "ColonelParrot"
  5. },
  6. "plugins": [
  7. {
  8. "name": "view-browser-tab",
  9. "source": "./",
  10. "description": "Screenshot open browser tabs for visual debugging."
  11. }
  12. ]
  13. }
README.md 路 README 路 109 lines
  1. <p align="center">
  2. <img src="https://raw.githubusercontent.com/puffinsoft/peek-cli/HEAD/assets/banner.png" width="400" />
  3. </p>
  4. <p align="center">
  5. peek-cli allows agents to capture a screenshot of any open tab in your browser.
  6. </p>
  7. <p align="center">
  8. Your agents can now iterate on frontend designs until they're flawless.
  9. </p>
  10. ---
  11. <p align="center">
  12. Works with Claude Code, Codex, Copilot and many more...
  13. </p>
  14. ![](https://raw.githubusercontent.com/puffinsoft/peek-cli/HEAD/assets/hero.png)
  15. ---
  16. <p align="center">
  17. See it in action:
  18. </p>
  19. https://github.com/user-attachments/assets/99c0614a-b622-40cb-8125-cd64ead9833e
  20. <p align="center">
  21. It works by using a browser extension to stream screenshots over WebSockets.
  22. </p>
  23. ---
  24. ### Usage
  25. *For security, you need to connect the agent once on every startup.*
  26. 1. Start the WebSocket daemon:
  27. ```bash
  28. peeked start
  29. > Successfully started server.
  30. ```
  31. 2. Connect your browser:
  32. <img src="https://raw.githubusercontent.com/puffinsoft/peek-cli/HEAD/assets/extension.png" width="300">
  33. 3. You're good to go!
  34. ```bash
  35. peeked list # view available tabs
  36. > [ 'http://localhost:3000/' ]
  37. peeked at http://localhost:3000 # capture screenshot
  38. > Image saved to: /var/.../peek_cli/images/dd999ee0.jpg
  39. ```
  40. ---
  41. ### Installation
  42. 1. Install the [Chrome Extension](https://chromewebstore.google.com/detail/peek-cli/fekplnpejnpnfmgikkleldnncgickmbb).
  43. <sup>馃帀 the extension has been approved on the Chrome Web Store!</sup>
  44. 2. Install the CLI
  45. ```bash
  46. npm i -g peeked
  47. ```
  48. 3. Install the Skill
  49. For Claude Code:
  50. ```bash
  51. /plugin marketplace add puffinsoft/peek-cli
  52. /plugin install view-browser-tab@peek-cli
  53. ```
  54. For Codex:
  55. ```bash
  56. codex plugin marketplace add puffinsoft/peek-cli
  57. codex plugin add view-browser-tab@peek-cli
  58. ```
  59. ---
  60. ### Examples
  61. ![](assets/cc.png)
  62. ---
  63. ### 鈿狅笍 Is this safe?
  64. Yes, 100%. It is impossible for the agent to do anything **but take a screenshot**.
  65. This is because the agent sends *screenshot requests* to the extension through a WebSocket server.
  66. It never accesses the browser and cannot inject any scripts / perform any actions.
  67. We invite you to take a look at the extension [source code](src/extension/background.ts) for added peace of mind.
  68. ---
  69. peek-cli is open source software, licensed under the [MIT](LICENSE) license.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it鈥檚 helped, pass it on.