Capture and automate macOS UI with the Peekaboo CLI.
Peekaboo is a powerful macOS UI automation command-line interface (CLI) that helps users capture, inspect, and automate interactions with macOS applications and UI elements. With its ability to interact with screens, windows, menus, and system dialogs, Peekaboo streamlines tasks like UI inspection, input automation, and application management. This tool is designed for those who need to automate repetitive tasks, test user interfaces, or develop scripts for macOS environments. By supporting both live capture and video ingest, it provides flexibility for various automation workflows, from simple actions to complex sequences.
The main features of Peekaboo include capturing screenshots, automating mouse and keyboard actions, managing app windows, and inspecting UI elements using a snapshot cache. Users can leverage a wide range of commands, such as 'click', 'drag', 'type', and 'scroll', along with powerful configuration options for customizing workflows. Peekaboo also integrates with macOS system features, including clipboard management, dock items, system menus, and more. Whether you are building automated UI tests, managing system tasks, or conducting UI inspections, Peekaboo provides a comprehensive toolkit to enhance your workflow. It is particularly suited for developers, testers, and power users looking to automate macOS tasks.
Peekaboo's use cases are ideal for anyone in need of advanced UI automation on macOS, such as quality assurance engineers, software developers, and those working with UI testing or screen recording. It is also highly beneficial for individuals automating repetitive tasks like app management, clipboard operations, or interacting with system dialogs. Whether you need to simulate user input, analyze UI layouts, or automate cross-app workflows, Peekaboo can save time and improve efficiency in a macOS environment.
Peekaboo is primarily used for macOS UI automation. It allows users to capture, inspect, and interact with macOS UI elements such as windows, menus, and app components. It is perfect for automating repetitive tasks, conducting UI testing, and managing macOS applications.
Peekaboo is supported only on macOS (Darwin), as indicated by its system compatibility metadata.
To install Peekaboo, you need to have the 'peekaboo' binary installed via the Homebrew package manager using the formula 'steipete/tap/peekaboo'. You can install it by running 'brew install steipete/tap/peekaboo'.
Peekaboo can interact with most macOS apps, as it provides commands for managing apps, windows, dialogs, and system menus. However, certain apps with restricted access (like those requiring elevated privileges) may require additional configuration.
Peekaboo provides several performance-related options, such as enabling smooth scrolling or typing delays to simulate human-like behavior. However, the responsiveness of the automation may vary depending on the complexity of the task, system performance, and the specific configuration of the automation.
Quick Setup:
.claude/skills/Repository
steipete/clawdis