peekaboo

Name: peekaboo
Availability: InStock
Author: softweek

Automate macOS UI interactions and capture screen content via Peekaboo CLI.

Updated Mar 7, 2026

Search Tags:#cli #macos #ui automation #screenshot #keyboard #mouse #gui testing

Ready to run

npx skills add https://github.com/softweek/openclaw --skill peekaboo-softweek

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

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

Core Features & Use Cases

UI Capture: Take screenshots of the entire screen, specific windows, or regions.
Element Interaction: Click, type, drag, and scroll through UI elements using various targeting methods.
App Management: Launch, quit, and manage application windows and states.
Use Case: Automate the process of filling out a complex web form within a desktop application by using peekaboo to navigate fields, input data, and submit the form.

Quick Start

Run peekaboo permissions to ensure the necessary access is granted 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 for desktop applications?▼

macOS UI automation can be performed using the Peekaboo CLI to simulate mouse clicks, keyboard typing, and scrolling. It targets specific interface elements to streamline repetitive desktop tasks and enables programmatic control over application windows.

Can I capture screenshots of specific windows during GUI testing on macOS?▼

Capturing screenshots of specific windows is supported during GUI testing on macOS. The Skill can capture the entire screen, individual windows, or specific regions to verify application states and visual content during automation workflows.

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

UI automation scripts on macOS require Screen Recording and Accessibility permissions to function. You can verify and grant these necessary access rights by running the `peekaboo permissions` command before starting your automation workflow.

What's the best way to fill out complex web forms inside desktop applications?▼

Filling out complex web forms inside desktop applications is best handled by using UI automation to navigate fields, input data, and submit the form. This approach uses element targeting and input simulation to script the entire process programmatically.

Why does my macOS UI automation script fail to interact with interface elements?▼

macOS UI automation scripts fail to interact with interface elements when Screen Recording and Accessibility permissions are not granted. Running the `peekaboo permissions` command ensures the necessary system access is configured for full functionality.