peekaboo

Automate macOS UI interactions and screen captures using the Peekaboo CLI tool.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with the macOS graphical user interface, allowing for programmatic control of applications, windows, and user input.

Core Features & Use Cases

  • UI Automation: Control applications, click elements, type text, and manage windows.
  • Screen Capture & Analysis: Capture screenshots and analyze UI elements for automation.
  • Use Case: Automate the process of filling out a complex software installation wizard by using Peekaboo to click through dialogs, enter text, and accept terms.

Quick Start

Run the peekaboo permissions command to check your macOS security settings.

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 like clicking and typing text programmatically?

You can automate macOS UI interactions by using the Peekaboo CLI to simulate input, manage windows, and target elements. It provides programmatic control over applications to streamline interface workflows.

Can I capture and analyze macOS screenshots during UI automation?

Yes, you can capture and analyze macOS screenshots during UI automation. The Skill supports screen captures and visual analysis of UI elements to verify and guide automated interactions.

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

Yes, macOS UI automation requires Screen Recording and Accessibility permissions. You can verify your security settings by running the peekaboo permissions command before executing automation scripts.

What is the best way to automate a complex software installation wizard on macOS?

The best way to automate a macOS installation wizard is using the Peekaboo CLI to click through dialogs, enter text, and accept terms. This programmatically handles multi-step interface sequences.

How do I manage application windows when scripting macOS UI automation?

You can manage application windows during macOS UI automation by utilizing the app and window management features. This allows scripts to control visibility and focus for targeted interactions.