steipete/peekaboo
skills/peekaboo/SKILL.md
macOS screenshots, UI inspect, clicks, typing, app/window automation.
$ install --global
skillsauthnpx skillsauth add steipete/agent-scripts peekabooInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 27, 2026, 6:00 AM294.0s1 file scanned
SKILL.md
- name:
- peekaboo
- description:
- macOS screenshots, UI inspect, clicks, typing, app/window automation.
Peekaboo
Use for macOS screen capture, UI inspection, and GUI automation.
Binary
- Prefer
~/bin/peekaboowhen present; it is Peter's local release copy. - Else use
peekaboo. - Check first:
~/bin/peekaboo --version || peekaboo --version.
Safety
- Check permissions before capture/automation:
peekaboo permissions status --json. - Screenshot needs Screen Recording; clicks/typing/window control need Accessibility.
- On remote Macs, Screenshot may be blocked by missing Screen Recording while clicks/typing still work through Accessibility; continue with clicks or DOM automation when the target is otherwise knowable.
- Prefer
--jsonfor machine parsing and--no-remotewhen testing local TCC. - Do not click/type/destructively automate unless user asked or target is a controlled test.
Common Commands
PB="${PEEKABOO_BIN:-$HOME/bin/peekaboo}"
[ -x "$PB" ] || PB="$(command -v peekaboo)"
"$PB" permissions status --json
"$PB" list screens --json
"$PB" list apps --json
"$PB" list windows --app Safari --json
"$PB" image --mode screen --screen-index 0 --path /tmp/screen.png --json --no-remote
"$PB" see --app frontmost --path /tmp/frontmost.png --json --annotate
"$PB" tools --json
"$PB" learn
"$PB" click --coords 100,100 --json
"$PB" type "text" --json
Workflow
- Resolve
PBas above and confirm version when install state matters. - Run
permissions status --json; if missing TCC, report exact missing grant. - For screenshots, use
image; include--path,--json, and usually--no-remote. - For element targeting, run
see --json --annotate, then click by element id/snapshot. - For long-running/change-aware screen capture, use
capture live; for video frame sampling, usecapture video. - Use
tools --jsonfor command/tool discovery andlearnwhen the full agent guide is useful. - Verify output files with
sips -g pixelWidth -g pixelHeight <path>or view the image.
Docs: ~/Projects/Peekaboo/docs/commands/.
Related Skills
steipete/openclaw-relay
data-ai
VerifiedTrustedCommunity
OpenClaw session relay: prompts/posts via local/remote acpx over SSH.
4,005SKILL.mdUpdated Apr 26, 2026
steipete/wrangler
tools
VerifiedTrustedCommunity
Wrangler CLI: Workers, KV, tail, deploy, account routing.
3,701SKILL.mdUpdated May 27, 2026
steipete/twilio-sms
tools
VerifiedTrustedCommunity
Twilio SMS CLI: buy/list/keep numbers, send/check messages, credential routing.
3,701SKILL.mdUpdated May 27, 2026
steipete/skill-cleaner
development
VerifiedTrustedCommunity
Audit Codex/OpenClaw skills: loaded roots, duplicate skills, unused skills, prompt-budget costs, compact descriptions.
3,701SKILL.mdUpdated May 27, 2026