emanueleielo/peekaboo
skills/peekaboo/SKILL.md
macOS UI automation: capture screenshots, click elements, type text, manage apps/windows/menus. Full desktop control via peekaboo CLI.
$ install --global
skillsauthnpx skillsauth add emanueleielo/ciana-parrot 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: Apr 21, 2026, 11:21 AM56.3s1 file scanned
SKILL.md
- name:
- peekaboo
- description:
- macOS UI automation: capture screenshots, click elements, type text, manage apps/windows/menus. Full desktop control via peekaboo CLI.
- requires_bridge:
- peekaboo
Peekaboo (macOS UI Automation)
Use the peekaboo bridge for full macOS UI automation: screenshots, clicks, typing, app/window management.
When to Use
- User asks to interact with a macOS app (click, type, screenshot)
- Capturing what's on screen
- Automating UI workflows
- Managing windows, menus, Dock
When NOT to Use
- Tasks that can be done via API/CLI -> prefer the specific bridge/skill
- Bulk automation -> consider AppleScript or Shortcuts instead
Commands
All commands run via host_execute(bridge="peekaboo", command="...").
See & Capture
peekaboo permissions # Check permissions
peekaboo see --annotate --path /tmp/peekaboo-see.png # Annotated screenshot
peekaboo image --mode screen --path /tmp/screen.png # Full screenshot
peekaboo image --app Safari --analyze "Summarize the page" # Screenshot + analysis
peekaboo list apps --json # List running apps
peekaboo list windows --app Safari --json # List windows
Interact
peekaboo click --on B1 # Click element by ID
peekaboo click --coords 500,300 # Click by coordinates
peekaboo type "Hello" --return # Type text + Enter
peekaboo hotkey --keys "cmd,shift,t" # Keyboard shortcut
peekaboo scroll --direction down --amount 5 # Scroll
App Management
peekaboo app launch "Safari" --open https://example.com
peekaboo app quit --app Safari
peekaboo window focus --app Safari
peekaboo menu click --app Safari --item "New Window"
Workflow: See -> Click -> Type
peekaboo see --app Safari --annotate --path /tmp/see.png # 1. See what's on screen
peekaboo click --on B3 --app Safari # 2. Click target element
peekaboo type "search query" --app Safari --return # 3. Type and submit
Setup (on host)
- Install:
brew install steipete/tap/peekaboo - Grant Screen Recording + Accessibility permissions in System Settings
- Uncomment
peekaboobridge inconfig.yaml, restart gateway
Related Skills
emanueleielo/whatsapp
tools
VerifiedTrustedCommunity
Send and read WhatsApp messages via the wacli CLI. Search chats, view history, send text and files to contacts or groups.
74SKILL.mdUpdated Apr 21, 2026
emanueleielo/weather
development
VerifiedTrustedCommunity
Get current weather and forecasts via wttr.in or Open-Meteo. Use when: user asks about weather, temperature, or forecasts for any location. NOT for: historical weather data, severe weather alerts, or detailed meteorological analysis. No API key needed.
74SKILL.mdUpdated Apr 21, 2026
emanueleielo/video-frames
tools
VerifiedTrustedCommunity
Extract frames, thumbnails, or clips from video files using ffmpeg. Use when analyzing video content or creating previews.
74SKILL.mdUpdated Apr 21, 2026
emanueleielo/troubleshooting
tools
VerifiedTrustedCommunity
Diagnose and resolve errors with Ciana's host bridges, CLI tools, Claude Code mode, macOS permissions, and gateway connectivity.
74SKILL.mdUpdated Apr 21, 2026