peekaboo

Automate macOS UI interactions and screen captures via command-line interface.

19|3|Updated Mar 7, 2026

Search Tags:#automation #testing #ui #cli #macos #screen capture

Ready to run

npx skills add https://github.com/samttoo22-MewCat/OpenSoul --skill peekaboo-samttoo22-mewcat

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/samttoo22-MewCat/OpenSoul/tree/main/openclaw/skills/peekaboo
Command: npx skills add https://github.com/samttoo22-MewCat/OpenSoul --skill peekaboo-samttoo22-mewcat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a powerful command-line interface to automate virtually any aspect of the macOS user interface, from capturing screens to interacting with applications and system elements.

Core Features & Use Cases

UI Automation: Control applications, windows, menus, and system dialogs.
Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
Input Simulation: Simulate mouse clicks, drags, typing, and hotkeys.
Use Case: Automate repetitive tasks like filling out forms in a desktop application, testing UI flows, or generating reports by capturing specific screen regions.

Quick Start

Run the peekaboo skill to check for necessary permissions on your macOS system.

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?▼

macOS UI automation via the command line allows you to control applications, windows, and menus. This Skill simulates mouse clicks, typing, and hotkeys to automate repetitive desktop tasks and testing flows.

Can I capture screen activity and analyze UI elements on macOS via CLI?▼

Screen capture and visual analysis via CLI enables you to record screen activity and inspect UI elements. This Skill captures screenshots and analyzes visual content directly from the command line.

Do I need special permissions to automate macOS user interface interactions?▼

Automating macOS UI interactions requires granting Screen Recording and Accessibility permissions to the tool. Running the Skill initially helps verify that these necessary system permissions are properly configured.

What is the best way to simulate mouse clicks and typing for macOS desktop automation?▼

Simulating mouse clicks, drags, and typing for macOS desktop automation is handled through command-line input simulation. This approach allows you to script complex interactions like filling out application forms.

Are there limitations when automating macOS system dialogs and menu navigation?▼

Automating macOS system dialogs and menu navigation depends on having the correct Screen Recording and Accessibility permissions. Without these authorized system privileges, the UI automation and visual analysis features will not function.