peekaboo

Automate macOS UI interactions via the Peekaboo CLI with YAML scripts.

Updated Jun 16, 2026
One-click install
npx skills add https://github.com/breakingcircuits1337/agent-skills --skill peekaboo-breakingcircuits1337
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/breakingcircuits1337/agent-skills/tree/main/peekaboo
Command: npx skills add https://github.com/breakingcircuits1337/agent-skills --skill peekaboo-breakingcircuits1337

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The Peekaboo Skill resolves the challenge of automating interaction with the macOS user interface, simplifying complex UI tasks like screenshotting, automating clicks, typing, and managing apps and windows.

Core Features & Use Cases

  • Automated UI Interactions: Perform tasks such as capturing screens, automating mouse and keyboard input, managing windows, and handling system dialogs.
  • Scripting & Automation: Utilize YAML scripts for automated, repeatable actions across macOS UI components.
  • Use Case: Streamline end-to-end application workflows, like automatically navigating through an application's UI, performing complex actions like file transfers and menu operations.

Quick Start

To launch a browser app, take a screenshot, and navigate through it using Peekaboo commands, you could say: 'Open Safari with the URL https://example.com'.

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

You can automate macOS UI interactions from the command line by utilizing the Peekaboo CLI to execute YAML scripts that simulate mouse and keyboard input, capture screenshots, and manage windows.

Can I script automated mouse clicks and keyboard typing for macOS applications?

Yes, you can script automated mouse clicks and keyboard typing for macOS applications using the Skill's script-based automation to generate input, target UI components, and handle system dialogs.

Do I need special system-level permissions to automate macOS window management and screenshots?

Yes, automating macOS window management and screenshots requires system-level permissions and access to UI components to simulate user interaction and manipulate application windows.

What is the best way to capture screenshots during automated UI testing on macOS?

The best way to capture screenshots during automated UI testing on macOS is using the Peekaboo CLI, which streamlines screenshot capture alongside automating clicks and navigation.

How does automated UI targeting work for macOS application navigation?

Automated UI targeting for macOS application navigation works by utilizing the Peekaboo CLI to identify and interact with specific UI components, enabling repeatable actions like file transfers and menu operations.