peekaboo

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

386k|81.1k|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/openclaw/openclaw --skill peekaboo-openclaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/openclaw/openclaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/openclaw/openclaw --skill peekaboo-openclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with the macOS graphical user interface, enabling complex workflows and repetitive tasks to be executed programmatically.

Core Features & Use Cases

  • UI Automation: Capture screens, inspect UI elements, and drive input (clicks, typing, gestures).
  • Application Management: Launch, quit, and manage windows of applications.
  • Use Case: Automate the process of filling out a complex software installation wizard by programmatically clicking through dialogs and entering required information.

Quick Start

Use the peekaboo skill to capture a screenshot of the frontmost window and save it to /tmp/screenshot.png.

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?

To automate macOS UI interactions from the command line, you can use the peekaboo skill to capture screens, inspect UI elements, and drive input like clicks, typing, and gestures programmatically.

Do I need special permissions to capture screen content and simulate input on macOS?

Yes, capturing screen content and simulating input on macOS requires Screen Recording and Accessibility permissions to be granted for full functionality.

Can I script complex GUI workflows like navigating a software installation wizard?

Yes, you can script complex GUI workflows like a software installation wizard by programmatically targeting UI elements, clicking through dialogs, and entering required information.

How do I capture a screenshot of the frontmost window to a specific file path?

You can capture a screenshot of the frontmost window and save it to a specific file path like /tmp/screenshot.png by executing a quick start command with the peekaboo skill.

What is the best way to manage application windows and inspect UI elements for agentic workflows?

The best way to manage application windows and inspect UI elements for agentic workflows is using a CLI tool that supports element targeting, window management, and visual analysis.