| name | peekaboo |
| description | Capture and automate macOS UI with the Peekaboo CLI. Screenshots, element inspection, click automation, and accessibility tree reading. Use when user says "screenshot this app", "click on button", "automate UI", "what's on screen".
|
| allowed-tools | ["Bash","Read","Write"] |
| model | haiku |
| user-invocable | true |
| when_to_use | When user wants to capture macOS screenshots, inspect UI elements, automate clicking/typing in apps, or read the accessibility tree. macOS only.
|
| argument-hint | <action: screenshot|inspect|click|type> [app name] [element] |
Peekaboo — macOS UI Automation
Capture and control macOS UI elements via the Peekaboo CLI.
Prerequisites
brew install steipete/tap/peekaboo
Requires macOS Accessibility permissions (System Settings → Privacy & Security → Accessibility).
Commands
| Command | Purpose |
|---|
peekaboo screenshot | Capture full screen |
peekaboo screenshot --app "Safari" | Capture specific app |
peekaboo screenshot --window-id N | Capture specific window |
peekaboo inspect --app "Finder" | List UI elements (accessibility tree) |
peekaboo click --app "App" --element "Button Name" | Click element |
peekaboo type --app "App" --element "TextField" --text "hello" | Type text |
peekaboo list-windows | List all open windows |
peekaboo list-apps | List running applications |
Usage Examples
/peekaboo screenshot Safari — capture Safari window/peekaboo inspect Finder — show all UI elements in Finder/peekaboo click "System Settings" "Wi-Fi" — click Wi-Fi in Settings
Rules
- Check if
peekaboo is installed: which peekaboo
- If not installed:
brew install steipete/tap/peekaboo
- macOS only — inform Linux/Windows users this skill is unavailable
- Screenshots saved to
workspace/screenshot-<app>-<timestamp>.png
- Always verify accessibility permissions if commands fail
