What problem does it solve?
macOS UI testing, repetitive interactions, and manual screenshot capture are time-consuming and error-prone; Peekaboo provides a consistent CLI to capture, inspect, and drive macOS user interfaces so tasks can be automated, reproduced, and scripted.
Core Features & Use Cases
- Automated screen and window capture with annotated UI maps and a snapshot cache for reproducible evidence.
- Precise element targeting and simulated input (click, type, drag, hotkey) for end-to-end testing, macro automation, and accessibility validation.
- System controls for app/window/menu/dock management and JSON output for integration with CI, bug reports, or downstream analysis; useful for reproducing login flows, generating annotated bug artifacts, and automating demo recordings.
Quick Start
Run peekaboo permissions to grant Screen Recording and Accessibility, then use peekaboo see --annotate --app Safari to capture an annotated snapshot and peekaboo click --on B3 --app Safari to interact with the page.