peekaboo

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

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/MoRen9527/TriMetaverse --skill peekaboo-moren9527
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/MoRen9527/TriMetaverse/tree/main/reference/openclaw/skills/peekaboo
Command: npx skills add https://github.com/MoRen9527/TriMetaverse --skill peekaboo-moren9527

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the tedious and error-prone process of interacting with macOS graphical user interfaces, enabling scripting and automation of complex UI tasks.

Core Features & Use Cases

  • UI Element Interaction: Click, type, drag, and scroll through UI elements with precision.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
  • App & Window Management: Launch, quit, and manipulate applications and their windows.
  • Use Case: Automate the process of logging into a desktop application by capturing the login window, typing credentials, and clicking the login button.

Quick Start

Run peekaboo permissions to check and grant 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 screen captures?

Automating macOS UI interactions and screen captures is done by scripting element targeting, input simulation, and visual analysis to execute deterministic tasks. This CLI approach allows you to click, type, and manage windows without manual intervention.

Do I need specific permissions to automate macOS GUI tasks?

Automating macOS GUI tasks requires Screen Recording and Accessibility permissions. You can check and grant these permissions by running the permissions command before attempting to script any user interface interactions or screen captures.

How can I script a desktop application login on macOS?

Scripting a macOS desktop application login involves capturing the login window, typing credentials, and clicking the login button. This is achieved through precise UI element interaction and input simulation provided by the CLI.

Can I capture screenshots and analyze visual content on macOS via CLI?

Capturing screenshots and analyzing visual content on macOS via CLI is fully supported. You can record screen activity and analyze visual content to verify UI states during automated task execution and scripting.

What is the best way to manage windows and applications in macOS automation scripts?

The best way to manage windows and applications in macOS automation scripts is using dedicated CLI commands to launch, quit, and manipulate application windows. This ensures deterministic task execution and reliable window management.

Why is my macOS UI automation script not clicking the correct elements?

macOS UI automation scripts may fail to click correct elements if Screen Recording and Accessibility permissions are not granted. Verify your permissions and use precise element targeting to ensure input simulation reaches the intended UI components.