Can I use Peekaboo for automated software testing?

Yes, Peekaboo is ideal for UI testing, allowing you to target elements by ID, title, or coordinates and simulate precise user interactions for regression testing.

Does Peekaboo support output for scripting?

Yes, Peekaboo supports --json and -j flags across its commands, making it easy to parse data for use in larger automation pipelines.

How do I find UI element IDs for automation?

You can use the 'peekaboo see --annotate' command to generate a UI map that identifies element IDs for targeting in your scripts.

Does Peekaboo work on Windows or Linux?

No, Peekaboo is specifically designed for macOS (Darwin) systems and relies on macOS-specific APIs for accessibility and screen recording.

What system permissions does Peekaboo require?

To function correctly, Peekaboo requires Screen Recording and Accessibility permissions to capture the screen and interact with UI elements.

Peekaboo macOS Automation

Name: Peekaboo macOS Automation
Author: clawdbot

byclawdbot

•

1,903

Productivity & Workflow

Automates and inspects the macOS user interface through a powerful command-line interface for system-level control.

About

Peekaboo is a comprehensive macOS UI automation tool that enables Claude to interact directly with the operating system's graphical interface. It provides robust capabilities to capture and inspect screens, identify specific UI elements, simulate complex user inputs like smart-clicks and gestures, and manage system-level components such as windows, menus, and the Dock. By bridging the gap between AI logic and the desktop environment, Peekaboo allows for the creation of sophisticated automation scripts that can control almost any macOS application, even those without native API support.

Key Features

Comprehensive macOS UI inspection and element targeting via ID or coordinates
1,903 GitHub stars
Simulated user interactions including smart-clicks, drag-and-drop, and human-like typing
System-wide application management for launching, quitting, and window positioning
Vision-enhanced screen capture with annotated UI maps and analysis tools
Native JSON output support for seamless integration into developer scripts and workflows

Use Cases

Automating repetitive workflows across multiple non-scriptable macOS applications
Performing AI-driven analysis and troubleshooting of desktop screen content
Creating end-to-end UI tests and visual regression checks for desktop software

About

Key Features

Comprehensive macOS UI inspection and element targeting via ID or coordinates
1,903 GitHub stars
Simulated user interactions including smart-clicks, drag-and-drop, and human-like typing
System-wide application management for launching, quitting, and window positioning
Vision-enhanced screen capture with annotated UI maps and analysis tools
Native JSON output support for seamless integration into developer scripts and workflows

Use Cases

Automating repetitive workflows across multiple non-scriptable macOS applications
Performing AI-driven analysis and troubleshooting of desktop screen content
Creating end-to-end UI tests and visual regression checks for desktop software