peekaboo

Automate macOS UI interactions via the Peekaboo CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manual macOS UI automation is tedious and error-prone. Peekaboo provides a CLI to capture screens, identify UI elements, and drive interactions programmatically, enabling repeatable UI tests and automation workflows.

Core Features & Use Cases

  • Capture screens, windows, and UI elements for validation and debugging.
  • Click, type, scroll, and control macOS apps and windows from the command line.
  • See and log UI state with annotated captures for reporting and QA.

Quick Start

Run a basic verification by executing peekaboo see or peekaboo list to confirm the CLI is installed and can interact with macOS UI.

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?

Automating macOS UI interactions from the command line is possible with the Peekaboo CLI, which clicks, types, scrolls, and controls apps programmatically. It enables repeatable UI tests and automation workflows.

Can I capture screens and identify UI elements for QA testing on macOS?

Yes, capturing screens and identifying UI elements for QA testing on macOS is supported. You can capture specific screens, windows, or elements, and generate annotated captures to log UI state for reporting.

What permissions do I need to run macOS UI automation tasks using Peekaboo?

Running macOS UI automation tasks requires the peekaboo binary installed via brew and macOS compatibility (darwin). You must also grant appropriate Screen Recording and Accessibility permissions to the CLI.

How do I verify that my macOS window management CLI is installed correctly?

To verify your macOS window management CLI is installed correctly, execute a basic check like peekaboo see or peekaboo list. This confirms the CLI can successfully interact with the macOS UI environment.

What is the best way to log UI state for debugging macOS apps?

The best way to log UI state for debugging macOS apps is using a CLI to capture annotated screenshots of windows and elements. This provides repeatable visual validation and reporting for development workflows.

Are there limitations when using a CLI for macOS screen capture and automation?

Limitations when using a CLI for macOS screen capture include strict dependency on macOS compatibility (darwin) and mandatory Screen Recording and Accessibility permissions, meaning it cannot run on non-macOS environments.