skills.rest
softweek
softweekCOMMUNITY
Explore all skills by this author →
GitHub

peekaboo

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
One-click install
npx skills add https://github.com/softweek/openclaw --skill peekaboo-softweek
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
X-School-AcademyX-School-Academy
9

dev-swarm-use-computer

Automate GUI interactions and screen capture for UI testing.

Official
Intermediate
dawsonblockdawsonblock

gui-automation

Automate mouse and keyboard interactions with screen capture for GUI testing.

Community
Intermediate
dsactivi-2dsactivi-2

peekaboo

Automate macOS UI interactions and system control via command-line interface.

Community
Advanced
malue-aimalue-ai
36

peekaboo

Automates macOS UI via command-line with targeting, input simulation, and screen management.

Official
Advanced