peekaboo

Automate macOS UI interactions with the Peekaboo CLI.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/Dolonia333/dolo.ai --skill peekaboo-dolonia333
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Dolonia333/dolo.ai/tree/main/skills/peekaboo
Command: npx skills add https://github.com/Dolonia333/dolo.ai --skill peekaboo-dolonia333

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo provides a full macOS UI automation CLI to capture, inspect, and drive UI elements, enabling repeatable UI tasks and automated testing without manual interaction.

Core Features & Use Cases

  • UI inspection: see and identify targets across apps, windows, and menus.
  • UI interaction: click, type, scroll, and manipulate windows and menus.
  • Automation workflows: script end-to-end UI scenarios and batch-test macOS applications.
  • Use Case: automate repetitive onboarding tasks by validating window flows and input handling across apps.

Quick Start

Install Peekaboo and run a basic see and click sequence to automate a macOS UI task.

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?

You can automate macOS UI tasks using a CLI tool that captures, inspects, and drives UI elements. This enables repeatable interactions like clicking and typing without manual input, supporting automated testing and workflow scripting on macOS.

What can I inspect and interact with during macOS app automation?

During macOS app automation, you can inspect and interact with targets across apps, windows, and menus. The automation supports commands to see, click, type, scroll, and manipulate window controls to script end-to-end UI scenarios.

Do I need to install a specific binary to run macOS UI automation workflows?

Yes, running macOS UI automation workflows requires installing the peekaboo binary on your macOS target. This CLI tool provides the necessary commands to capture, inspect, and drive UI elements for automated testing.

How do I script end-to-end UI scenarios for testing macOS applications?

You can script end-to-end UI scenarios by sequencing commands for seeing, clicking, and typing within macOS applications. This allows you to batch-test applications and automate repetitive onboarding tasks by validating window flows and input handling.

Can I use this approach to automate repetitive onboarding tasks on macOS?

Yes, you can automate repetitive onboarding tasks on macOS by validating window flows and input handling across apps. The automation CLI drives UI interactions to ensure repeatable UI tasks without manual intervention.

What are the limitations of using a CLI for macOS window management and UI automation?

Using a CLI for macOS window management and UI automation requires the target application to be running on macOS. It relies on the peekaboo binary to execute commands, meaning tasks are constrained to the supported see, click, type, and window control actions.