What problem does it solve?
Peekaboo automates macOS user interface tasks like clicking, typing, window/menu navigation, permissions setup, and UI inspection so you don’t have to perform repetitive manual steps.
Core Features & Use Cases
- UI discovery and inspection: Use
list and see to locate apps, windows, screens, menus, and interactive elements (with refreshed element IDs after changes) for reliable targeting.
- Deterministic UI actions with verification: Follow observe → act → verify to click, type, paste, press hotkeys, scroll, drag, and interact with dialogs/panels while reducing flaky automation.
- Permission and Bridge troubleshooting: Use permissions status and Bridge status to diagnose failures related to macOS TCC requirements and host/remote execution differences.
- Agent and MCP tooling: Run Peekaboo as an MCP server or use agent-oriented commands for higher-level automation while still respecting safety/confirmation rules for destructive actions.
Quick Start
Ask the AI agent to use Peekaboo to open the target app, observe the relevant UI with a fresh element map, perform the required click or typing action using element IDs, and then verify the result with a new see or list output.