peekaboo

Automate macOS UI tasks across apps and windows using the Peekaboo CLI.

1|Updated Mar 6, 2026

Search Tags:#automation #testing #cli #macos #scripting #peekaboo #ui-automation

Ready to run

npx skills add https://github.com/zhcndoc/openclaw --skill peekaboo-zhcndoc

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS users need a reliable and scriptable way to automate UI interactions, capture state, and drive app flows without brittle manual clicks.

Core Features & Use Cases

Core automation: capture, identify UI elements, and perform clicks, typing, and window management across macOS apps.
Scripting and repeatability: build repeatable UI automation workflows that can be invoked from CLI or scripts.
Use Case: Automate repetitive onboarding tasks in a macOS app by selecting elements, performing sequences, and verifying outcomes.

Quick Start

Install Peekaboo and run a simple automation by listing apps or inspecting a window, then drive actions in a scripted flow.

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 from the command line?▼

macOS UI automation from the command line involves capturing screen state, identifying UI elements, and executing actions like clicks and typing across apps. This approach enables scriptable, repeatable workflows without brittle manual clicks.

Can I script repetitive app interactions in macOS without manual clicks?▼

Yes, you can script repetitive macOS app interactions by building CLI-invoked workflows that select UI elements and perform action sequences. This replaces brittle manual clicks with repeatable scripts that drive app flows and verify outcomes.

Do I need to install the Peekaboo binary to run macOS UI automation?▼

Yes, reliable macOS UI automation requires the installed Peekaboo binary and its platform-specific prerequisites. The tool depends on this binary to capture state, identify targets, and execute actions within real macOS environments.

What is the best way to inspect and interact with macOS app windows via CLI?▼

The best way to inspect and interact with macOS app windows via CLI is using a dedicated UI automation tool. You can list running apps, inspect window states, and then drive scripted actions like typing and clicking to automate flows.

How does visual UI element identification work for macOS scripting?▼

Visual UI element identification for macOS scripting works by capturing the screen state and visually identifying targets across apps and windows. The automation tool then executes targeted actions and validates the resulting outcomes in the real macOS environment.