peekaboo

Automate macOS UI interactions with a CLI tool requiring Screen Recording and Accessibility permissions.

5|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/JansenAnalytics/claudex --skill peekaboo-jansenanalytics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/JansenAnalytics/claudex/tree/main/skills/peekaboo
Command: npx skills add https://github.com/JansenAnalytics/claudex --skill peekaboo-jansenanalytics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture and automate macOS UI interactions to reduce repetitive manual tasks and speed up UI testing and demos.

Core Features & Use Cases

  • Capture and inspect screens, target UI elements, and drive input across macOS apps and system UI.
  • Launch, manage, and automate windows, menus, and app workflows for testing, accessibility checks, and demos.
  • Use cases include scripted UI testing, onboarding demonstrations, and automated UI capture for documentation.

Quick Start

Install Peekaboo, enable Screen Recording and Accessibility permissions, and run a basic automation sequence.

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 interactions for testing and demos?

Automate macOS UI interactions by scripting app launches, window management, and input simulation to reduce repetitive manual tasks. It targets UI elements directly, enabling scripted testing and onboarding demonstrations without manual intervention.

Do I need special permissions to run macOS UI automation scripts?

macOS UI automation requires granting Screen Recording and Accessibility permissions to the CLI tool. These permissions allow scripts to capture screens, inspect UI elements, and simulate user input across system and app windows securely.

Can I capture screenshots and inspect UI elements on macOS programmatically?

You can capture screenshots and inspect UI elements on macOS programmatically using CLI scripting. The automation tool identifies and targets specific UI elements, allowing scripts to capture screen state and interact with menus, windows, and app workflows.

What is the best way to script onboarding demonstrations for macOS apps?

Scripting onboarding demonstrations for macOS apps is best achieved using CLI-based UI automation to simulate real-world workflows. It launches apps, manages windows, and drives input automatically, ensuring consistent, repeatable demos without manual clicking.

How does safe targeting and error handling work during macOS UI automation?

Safe targeting and error handling during macOS UI automation work by enforcing strict validation of UI elements before interaction. The tool verifies element targets and manages errors during input simulation, preventing unsafe actions and ensuring reliable automated workflows.

Are there limitations when using CLI scripting for macOS UI automation?

Limitations of CLI scripting for macOS UI automation include strict dependency on Screen Recording and Accessibility permissions, and the need for precise UI element targeting. Scripts may fail if app interfaces change unexpectedly or if permissions are revoked.