← Back to Skills Marketplace
Peekaboo 1
by
tonydesign1999
· GitHub ↗
· v1.0.0
· MIT-0
274
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install peekaboo-1
Description
Capture and automate macOS UI with the Peekaboo CLI.
Usage Guidance
This skill appears to be what it says: a macOS UI automation CLI that must be installed as a binary and requires Screen Recording and Accessibility permissions (these let it capture your screen and control input). Before installing: 1) Verify the Homebrew tap (steipete/tap) and inspect the upstream project or source code/release artifacts if possible; 2) Understand that any screenshots, clipboard contents, or dialogs it reads can contain sensitive data — only run it with apps/windows you trust or in a controlled environment; 3) Investigate the 'bridge' feature (network connectivity) if you plan to use it — confirm where data would be sent and whether credentials are required; 4) Prefer official/homebrew/core packages when available and check the project's homepage/repo for reputation and signed releases. If you need higher assurance, ask the publisher for source or a reproducible build and review it before installing.
Capability Analysis
Type: OpenClaw Skill
Name: peekaboo-1
Version: 1.0.0
The skill provides a comprehensive interface for the 'peekaboo' macOS UI automation CLI, which includes high-risk capabilities such as screen capture, clipboard access, and simulated keyboard/mouse input (SKILL.md). While these features are aligned with the tool's stated purpose of UI automation and testing, the ability to record the screen, read the clipboard, and programmatically interact with other applications (including examples of typing passwords into browsers) constitutes a significant attack surface. No clear evidence of intentional malice or data exfiltration was found, but the broad system access warrants a cautious classification.
Capability Assessment
Purpose & Capability
Name/description, required binary (peekaboo), and declared install (Homebrew formula steipete/tap/peekaboo) match the claimed macOS UI automation purpose. No unrelated env vars, binaries, or config paths are requested.
Instruction Scope
SKILL.md instructs only use of the peekaboo CLI (captures, clicking, typing, clipboard access, permissions checks). These actions are appropriate for a UI automation tool, but several capabilities (screen capture, clipboard read/write, system dialog interaction) inherently allow access to sensitive user data — this is expected for the tool's purpose but worth highlighting. The 'bridge' command suggests optional network/host connectivity; SKILL.md does not document where bridge connects or whether captures are sent off‑host.
Install Mechanism
Install uses a Homebrew formula from a third‑party tap (steipete/tap). Homebrew installs are common and reasonable, but third‑party taps are higher risk than core/homebrew/core packages because they host arbitrary binaries. No raw URL downloads or extract steps are present.
Credentials
No environment variables or credentials are required by the skill metadata. SKILL.md references 'config' for providers/models/credentials (optional runtime config), which could request credentials later, but nothing in the package requires broad secrets up front.
Persistence & Privilege
Skill is not always-on and does not request system-wide configuration changes. Autonomous model invocation is allowed (platform default) but the skill does not request elevated persistent privileges or modify other skills' configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install peekaboo-1 - After installation, invoke the skill by name or use
/peekaboo-1 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Peekaboo, a macOS UI automation CLI.
- Provides comprehensive CLI commands to capture, inspect, and automate macOS UI elements, input, apps, and windows.
- Supports screen/window/region capture, element targeting, snapshot annotation, and UI interaction (click, type, drag, swipe, scroll).
- Manages apps, windows, dialogs, Dock, and menu items; includes clipboard and Spaces commands.
- Features scripting-friendly options (`--json`, `--verbose`), snapshot cache, and command-specific targeting parameters.
- Includes extensive quickstart instructions and practical command examples.
- Installation available via Homebrew. Requires Screen Recording and Accessibility permissions.
Metadata
Frequently Asked Questions
What is Peekaboo 1?
Capture and automate macOS UI with the Peekaboo CLI. It is an AI Agent Skill for Claude Code / OpenClaw, with 274 downloads so far.
How do I install Peekaboo 1?
Run "/install peekaboo-1" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Peekaboo 1 free?
Yes, Peekaboo 1 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Peekaboo 1 support?
Peekaboo 1 is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin).
Who created Peekaboo 1?
It is built and maintained by tonydesign1999 (@tonydesign1999); the current version is v1.0.0.
More Skills