peekaboo

Automate macOS UI interactions with screen capture, element targeting, and input simulation.

Updated Jan 20, 2026

Search Tags:#accessibility #cli #macos #scripting #ui automation #screen capture

Ready to run

npx skills add https://github.com/Team-Hireal/RealChat --skill peekaboo-team-hireal

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Team-Hireal/RealChat/tree/main/openclaw/skills/peekaboo
Command: npx skills add https://github.com/Team-Hireal/RealChat --skill peekaboo-team-hireal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the capture, inspection, and interaction with macOS user interfaces, streamlining repetitive tasks and enabling programmatic control of applications and system elements.

Core Features & Use Cases

UI Automation: Drive applications, click elements, type text, and perform gestures.
Screen Capture & Analysis: Capture screenshots, record videos, and analyze UI states.
System Interaction: Manage apps, windows, menus, and system dialogs.
Use Case: Automate the process of filling out a complex software installation wizard by scripting clicks, text inputs, and selections.

Quick Start

Run peekaboo permissions to check for necessary macOS permissions.

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 script application windows?▼

To automate macOS UI interactions, you can use a CLI tool to script element targeting, input simulation, and application window management. This allows programmatic control over repetitive desktop tasks and system dialogs without manual intervention.

Do I need special permissions for macOS screen capture and UI automation?▼

Yes, macOS UI automation requires granting Screen Recording and Accessibility permissions. You can check if your environment has the necessary permissions configured by running a specific command to ensure scripts can capture screens and simulate inputs.

Can I script complex system dialogs and installation wizards on macOS?▼

Yes, you can script complex macOS installation wizards by automating clicks, typing text, and selecting options. This system interaction capability handles repetitive UI tasks by programmatically driving application menus and dialog buttons.

What is the best way to capture screenshots and analyze UI states programmatically?▼

The best way to capture screenshots and analyze UI states is using a CLI designed for macOS UI automation. It enables you to capture screen images, record videos, and inspect application elements directly from your scripts.

Does this macOS UI automation tool support input simulation and gestures?▼

Yes, macOS UI automation tools support input simulation including clicking elements, typing text, and performing gestures. This enables comprehensive programmatic control over applications and system interfaces.