Peekaboo

What it does

Peekaboo provides a comprehensive macOS UI automation command-line interface for capturing screenshots, inspecting UI elements, driving mouse and keyboard input, and managing applications and windows. It exposes commands for capture, element targeting, simulated input (click/type/drag/hotkey), window and Dock management, and annotated UI mapping. The tool is designed for scripting and can emit JSON for programmatic consumption.

When to use it

Use Peekaboo when you need to automate or test macOS graphical user interfaces, take annotated screenshots for debugging, programmatically interact with UI elements by ID or coordinates, drive complex input sequences, or manage app windows and spaces. It is well-suited for CI tasks, reproducible UI workflows, and agents that require visual context.

What's included

• Scripts: none detected in this package (has_scripts=false).
• References: no separate references folder detected.
• Instructions: detailed CLI documentation covering capture, image analysis, element targeting, input actions (click/drag/type/press), app/window/menu management, and examples for common flows (see->click->type, capture+analyze, live capture).

Compatible agents

Likely compatible with agents that can run system CLIs and shells (Copilot/Codex/Gemini CLI-style agents) on macOS hosts that provide screen recording and accessibility permissions.