peekaboo

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

Updated Mar 3, 2026

Search Tags:#cli #macos #scripting #ui automation #gui #peekaboo

Ready to run

npx skills add https://github.com/hammadparveez/mrhammadclaw --skill peekaboo-hammadparveez

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/hammadparveez/mrhammadclaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/hammadparveez/mrhammadclaw --skill peekaboo-hammadparveez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with the macOS graphical user interface, enabling programmatic control over applications, windows, and user input.

Core Features & Use Cases

UI Automation: Control apps, windows, menus, and UI elements.
Input Simulation: Simulate clicks, typing, hotkeys, and gestures.
Screen Capture & Analysis: Capture screenshots and analyze UI content.
Use Case: Automate the process of filling out a complex form in a desktop application by using Peekaboo to navigate fields, type data, and click buttons.

Quick Start

Run peekaboo permissions to check necessary macOS permissions for UI automation.

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 and simulate user input programmatically?▼

You can automate macOS UI interactions by using this tool to launch applications, manage windows, and simulate clicks, typing, and hotkeys. It enables programmatic control over desktop applications and graphical interfaces.

Do I need special macOS permissions to run GUI automation scripts and capture screens?▼

Yes, macOS GUI automation and screen capturing require explicit Screen Recording and Accessibility permissions. You can verify your system's authorization status by running the `peekaboo permissions` command before executing any automation scripts.

Can I capture specific screen regions and analyze UI content on a full desktop?▼

Yes, you can capture both specific screen regions and full desktops to analyze UI content. The tool allows you to programmatically take screenshots of the macOS environment and extract visual information from the captured graphical user interface.

What is the best way to automate filling out a complex form in a desktop application?▼

The best way to automate filling out a complex desktop form is to use UI automation to programmatically navigate fields, type data, and click buttons. This simulates human interaction with the graphical interface to complete the input process reliably.

Why is my macOS UI automation script not working or failing to control applications?▼

macOS UI automation fails when the necessary Screen Recording and Accessibility permissions are not granted to the controlling process. Running the `peekaboo permissions` diagnostic command helps identify and resolve these missing system authorizations.