peekaboo

Automate macOS UI workflows with the Peekaboo CLI.

Updated Apr 7, 2026

Search Tags:#accessibility #cli #macos #peekaboo #automation-testing #screen-capture #ui-automation

Ready to run

npx skills add https://github.com/Luzzer/Kraken --skill peekaboo-luzzer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Luzzer/Kraken/tree/main/skills/peekaboo
Command: npx skills add https://github.com/Luzzer/Kraken --skill peekaboo-luzzer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo simplifies macOS UI automation by providing a single CLI to inspect, target, and drive UI elements across apps, reducing repetitive manual interactions.

Core Features & Use Cases

Full macOS UI automation CLI for capturing, inspecting, targeting UI elements, driving input, and managing apps/windows/menus.
Supports live feedback, scripting, and automated UI workflows across native macOS apps.

Quick Start

Execute a simple command to verify the tool and explore its capabilities.

Frequently Asked Questions about peekaboo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I automate macOS UI tasks across native apps and system dialogs?▼

macOS UI automation is handled by using a single CLI to inspect, target, and drive UI elements across apps, windows, and system dialogs. This reduces repetitive manual interactions by supporting live feedback and scripting for automated workflows.

Do I need specific permissions to run macOS UI automation scripts?▼

Yes, macOS UI automation requires granting Screen Recording and Accessibility permissions to the CLI tool. You must also be running the macOS (darwin) operating system and have the necessary binary installed via a supported package manager.

Can I capture screens and inspect UI elements for automation testing on macOS?▼

Yes, you can perform screen capture and UI element inspection for automation testing on macOS. The CLI enables you to target specific elements, drive input, and manage apps or windows while providing live feedback during the testing workflow.

What is the best way to script interactive workflows for native macOS apps?▼

The best way to script interactive workflows for native macOS apps is using a dedicated CLI that supports live feedback. It simplifies the process of inspecting and targeting UI elements to drive input and manage menus across various applications.

Are there limitations when using a CLI for macOS UI automation?▼

A primary limitation of CLI-based macOS UI automation is its strict dependency on the macOS platform. It requires explicit Screen Recording and Accessibility permissions to function correctly, meaning it cannot be used on non-darwin operating systems.

Does peekaboo support managing windows and menus during automated UI workflows?▼

Yes, peekaboo supports managing windows and menus during automated UI workflows. It provides a full CLI to inspect, target, and drive UI elements across native macOS apps, enabling scripted control over interactive system dialogs and application interfaces.