peekaboo

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

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/brianwan19801015/labopenclaw --skill peekaboo-brianwan19801015
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/brianwan19801015/labopenclaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/brianwan19801015/labopenclaw --skill peekaboo-brianwan19801015

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

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

Core Features & Use Cases

  • UI Automation: Control clicks, typing, drags, and gestures across applications.
  • Screen Capture & Analysis: Capture screenshots, record screen regions, and analyze UI elements.
  • App & Window Management: Launch, quit, focus, and manipulate application windows.
  • Use Case: Automate the process of logging into a web application by controlling the browser's UI elements, or extract data from a desktop application by capturing screenshots and identifying specific text.

Quick Start

Run peekaboo permissions to check for 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 from the command line?

You can automate macOS UI interactions from the command line by using the Peekaboo CLI to simulate inputs like clicks, typing, and drags across system applications.

What macOS permissions are required for GUI scripting and screen capture?

GUI scripting and screen capture on macOS require explicit Screen Recording and Accessibility permissions, which you can verify and grant by running the peekaboo permissions command.

Can I capture screenshots and analyze UI elements on macOS programmatically?

Yes, you can capture screenshots and analyze UI elements programmatically because the Skill supports capturing screen content, recording regions, and identifying specific text or elements.

How do I launch, focus, and manage application windows in macOS automation scripts?

To launch, focus, and manage application windows in macOS automation scripts, use the Peekaboo CLI's app and window management features to manipulate target application states.

What is the best way to automate logging into a web application via macOS UI automation?

The best way to automate logging into a web application via macOS UI automation is controlling the browser's UI elements directly, simulating keystrokes and clicks to enter credentials.

Are there limitations when using CLI tools for macOS UI automation?

Limitations when using CLI tools for macOS UI automation include strict dependencies on system-level Screen Recording and Accessibility permissions, which must be granted or the automation will fail.