peekaboo

Automate macOS UI interactions via the Peekaboo CLI.

1|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/karaabd23-crypto/openclaw --skill peekaboo-karaabd23-crypto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/karaabd23-crypto/openclaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/karaabd23-crypto/openclaw --skill peekaboo-karaabd23-crypto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo addresses the challenge of manual macOS UI testing and automation by providing a CLI to inspect, target, and drive UI elements, capture screens, and manage applications.

Core Features & Use Cases

  • UI inspection and element targeting across macOS apps and windows
  • Automated input, window/app management, and menu/dock interactions
  • Screenshots, video capture, and annotated analysis for debugging

Quick Start

Run a quick UI capture of the active window using Peekaboo.

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 by using a CLI to inspect, target, and drive UI elements across applications and windows. This allows you to script automated input, manage windows, and trigger menu or dock interactions directly from the terminal.

Can I capture screenshots and record video of macOS applications for debugging?

Yes, you can capture screens, record video, and perform annotated analysis of macOS applications. This enables automated visual debugging and UI inspection directly within your testing workflows.

Do I need special permissions to control macOS UI elements in automation scripts?

Yes, macOS requires appropriate permissions to control UI and screen input. You must grant accessibility and screen recording permissions to the CLI tool driving the UI automation tasks before executing your scripts.

What is the best way to inspect and target UI elements across macOS windows?

The best way to inspect and target UI elements is using a dedicated automation CLI that interacts directly with macOS app windows. This approach allows precise element targeting and automated input management within your workflows.

Why is my macOS UI automation not working when triggered by a CLI?

macOS UI automation fails when the CLI lacks the necessary system permissions to control UI and screen input. Ensure the automation tool has been explicitly granted accessibility and screen recording access in your system settings.