peekaboo

Automate macOS UI tasks by capturing screens, targeting elements, and simulating input.

2|1|Updated Mar 8, 2026

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

Ready to run

npx skills add https://github.com/duggal1/Sapphire-cli --skill peekaboo-duggal1

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/duggal1/Sapphire-cli/tree/main/internal/skills/bundled/peekaboo
Command: npx skills add https://github.com/duggal1/Sapphire-cli --skill peekaboo-duggal1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually interacting with macOS UI—clicking, typing, and navigating windows—becomes error-prone and time-consuming; Peekaboo automates these tasks from the command line to boost consistency and speed.

Core Features & Use Cases

Full macOS UI automation CLI: capture screens, identify UI elements, simulate input, and manage apps, windows, and menus.
Scriptable workflows: integrates with JSON-friendly outputs and flags for automation pipelines and testing.
Use Case: rapidly automate repetitive UI testing across multiple apps, capture visual state, and drive input to validate app behavior.

Quick Start

Install Peekaboo and run the CLI with basic commands to start automating macOS UI tasks.

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 screens, targeting UI elements, and simulating input across applications. Peekaboo provides modular commands and JSON-friendly outputs to drive these scripted UI interactions and automate repetitive workflows.

Can I chain macOS UI automation commands in a scripting pipeline?▼

Yes, you can chain macOS UI automation commands in scripting pipelines by leveraging JSON-friendly outputs and modular CLI flags. Peekaboo integrates screen captures and input simulation into automated testing environments for scriptable workflows.

Does this CLI tool support identifying and targeting specific UI elements on macOS?▼

Yes, the CLI tool supports identifying and targeting specific UI elements on macOS. Peekaboo automates interactions across windows, menus, and dialogs, allowing scripts to drive input and capture visual state to validate app behavior.

What is the best way to capture visual state during macOS UI testing?▼

Capturing visual state during macOS UI testing is best handled by a CLI tool that scriptably captures screens and drives input. Peekaboo captures visual state and outputs JSON-friendly data to validate app behavior across multiple apps.

Do I need any dependencies to run Peekaboo for macOS UI automation?▼

No dependencies are required to run Peekaboo for macOS UI automation. The Skill operates independently to automate screen captures, target UI elements, and simulate input without requiring external components.