skills.rest
qsimeon
qsimeonCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

peekaboo

Automates macOS UI interactions via command-line, including screen capture, element inspection, and input simulation.

1|1|Updated Feb 17, 2026
Search Tags:#testing#cli#macos#scripting#ui automation#gui
One-click install
npx skills add https://github.com/qsimeon/openclaw-engaging --skill peekaboo-qsimeon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/qsimeon/openclaw-engaging/tree/main/skills/peekaboo
Command: npx skills add https://github.com/qsimeon/openclaw-engaging --skill peekaboo-qsimeon

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: Capture screenshots, inspect UI elements, and drive mouse and keyboard input.
  • Application Control: Launch, quit, and manage applications and their windows.
  • Use Case: Automate repetitive tasks like filling out forms in a desktop application, testing UI flows, or generating reports by interacting with various macOS applications.

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

To automate macOS UI interactions from the command line, you can use a CLI tool to programmatically capture screenshots, inspect UI elements, and simulate mouse clicks and keyboard typing. This enables automated testing and scripting of desktop applications.

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

Yes, macOS UI automation requires granting Screen Recording and Accessibility permissions to the tool. You can verify these permissions are enabled correctly by running the dedicated permissions check command before executing your automation scripts.

What can I automate with macOS GUI scripting?▼

With macOS GUI scripting, you can automate repetitive desktop tasks like filling out application forms, testing UI flows, and generating reports. This involves launching applications, managing windows, and driving user input such as gestures and typing.

How do I inspect macOS UI elements for automation testing?▼

To inspect macOS UI elements for automation testing, you use a CLI tool to capture screen content and programmatically examine the interface properties of applications. This allows your scripts to accurately identify targets before simulating user interactions.

Why is my macOS UI automation script not triggering clicks or typing?▼

If macOS UI automation is not triggering clicks or typing, it typically means the required Screen Recording and Accessibility permissions are missing or blocked. You must explicitly grant these system permissions for the CLI to successfully simulate user input.

Related Skills

Explore More Software Engineering Skills→
rafaelcallejarafaelcalleja
2

gemini-cli

Interact with Gemini AI models through a command-line interface.

Community
Intermediate
anhtesteranhtester
129

Flaky Test Analyzer

Analyze intermittent test failures and propose remediation steps.

Community
Intermediate
0xHoneyJar0xHoneyJar
5

peekaboo

Automate macOS UI interactions and screen captures via the Peekaboo CLI.

Official
Intermediate
autonomy-cloudautonomy-cloud
2

macos-automation

Automate native macOS app interactions using AppleScript via osascript.

Official
Intermediate