peekaboo

Automate macOS UI tasks via CLI with JSON output.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/abhiunix/community-registry --skill peekaboo-abhiunix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/abhiunix/community-registry/tree/main/skills/media/peekaboo
Command: npx skills add https://github.com/abhiunix/community-registry --skill peekaboo-abhiunix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo provides a command-line interface to automate macOS UI tasks such as capturing screens, targeting UI elements, driving input, and managing applications, enabling repeatable UI interactions for testing, demos, and automation workflows.

Core Features & Use Cases

  • Inspect and target windows, controls, and menus across macOS apps
  • Drive input like clicks, keystrokes, and navigation to simulate real user flows
  • Capture screenshots or video and review interactions for QA or demos
  • Use in CI pipelines to reproduce UI interactions and verify behavior

Quick Start

Install Peekaboo and run a simple command to inspect a window, click a control, and capture a screenshot.

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?

Automate macOS UI tasks by using a CLI to orchestrate screen capture, UI element targeting, and input control. It provides commands to inspect windows, drive clicks and keystrokes, and manage applications for repeatable automated workflows.

Can I capture screenshots and simulate user input during macOS testing?

Yes, you can capture screenshots or video while simulating real user flows by driving clicks and keystrokes. This enables you to review interactions for QA, demos, and automated testing across macOS applications.

Does this CLI tool support integration with CI pipelines for UI automation?

Yes, it supports integration with CI pipelines to reproduce UI interactions and verify behavior. It produces JSON output from its commands, making it scriptable and easy to integrate into automated development workflows.

What is the best way to inspect and target UI elements across macOS apps?

The best way to inspect and target UI elements is using the 'see' command, which identifies windows, controls, and menus across macOS apps. This allows precise targeting for subsequent automated interactions like clicking and typing.

Are there limitations when using command-line UI automation for macOS workflows?

A key limitation is that command-line UI automation depends on macOS accessibility features to target elements and drive input. Complex, dynamically rendered interfaces may also present challenges for reliable element targeting during automated workflows.