peekaboo

Automate macOS UI interactions via command-line interface and Python libraries.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the capture and interaction with macOS UI elements, streamlining UI automation tasks and reducing manual effort.

Core Features & Use Cases

  • UI Automation: Capture/inspect screens, target UI elements, drive input, and manage apps/windows/menus.
  • Scripting: Execute operational instructions through a CLI, supporting JSON for scripting.
  • Use Case: Automate repetitive tasks like launching apps, clicking buttons, typing text, and capturing screenshots for testing or documentation.

Quick Start

Use the peekaboo skill to capture a screenshot of the current screen and save it to '/path/to/image.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?

You can automate macOS UI interactions from the command line by using the peekaboo CLI to drive input, target UI elements, and manage apps or windows. It supports executing scripts and capturing screenshots for automation tasks.

Can I capture screenshots on macOS using a CLI script?

Yes, you can capture screenshots on macOS using a CLI script. The peekaboo tool allows you to capture and inspect screens, saving the output directly to a specified file path for testing or documentation generation.

What is the best way to automate UI tests on macOS without manual effort?

Automating UI tests on macOS is best handled by scripting operational instructions through a CLI. You can launch apps, click buttons, type text, and capture screenshots programmatically using the peekaboo binary and Python libraries.

Do I need Python libraries to automate macOS screen capture and UI targeting?

Yes, you need Python libraries for UI interaction along with the peekaboo binary to automate macOS screen capture and UI targeting. These dependencies are required to execute the automation scripts and manage the interface elements.

Does the peekaboo CLI support JSON for scripting macOS automation tasks?

Yes, the peekaboo CLI supports JSON for scripting macOS automation tasks. This allows you to structure operational instructions for launching apps, driving input, and managing windows or menus programmatically.

What are the limitations of using a CLI for macOS UI automation?

Using a CLI for macOS UI automation requires the specific peekaboo binary and Python libraries to be installed. It is limited to macOS systems and relies on targeting UI elements programmatically, which may require adjustments if interfaces change.