peekaboo

Automates macOS UI via CLI commands like see, click, and type.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/Solitude01/proiect-new --skill peekaboo-solitude01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Solitude01/proiect-new/tree/main/%E5%88%9B%E6%84%8F/%E9%A3%9E%E7%89%9B/OPENCLAW/openclaw/openclaw/skills/peekaboo
Command: npx skills add https://github.com/Solitude01/proiect-new --skill peekaboo-solitude01

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo simplifies macOS UI automation by enabling capture, inspection, and control of screens, UI elements, and application windows through a single CLI.

Core Features & Use Cases

  • Capture and inspect screens, target UI elements, drive input, and manage apps/windows/menus.
  • Share a snapshot cache and script workflows with JSON-style flags like --json and --help.
  • Use cases include automated UI testing, repetitive UI tasks, and scripting complex UI interactions across macOS apps.

Quick Start

Run a simple see command to identify a target, then interact with it using a follow-up command such as peekaboo click.

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 controlling screens, elements, and apps through a CLI. Use commands like see to identify targets and click to interact with them, enabling scripted UI workflows and automated testing.

Do I need special permissions to automate screen capture and UI elements on macOS?

Yes, macOS UI automation requires granting Screen Recording and Accessibility permissions. These system-level permissions allow the CLI to capture screens, inspect UI elements, and drive input across applications.

Can I script complex UI workflows and repetitive UI tasks on macOS?

Yes, you can script complex UI workflows and repetitive tasks using JSON-style flags like --json. This enables you to share a snapshot cache and script automated interactions across macOS apps.

What's the best way to inspect and target UI elements for automated testing on macOS?

The best way to inspect and target UI elements is using the see command to identify a target, then interacting with it using commands like peekaboo click or type for automated UI testing workflows.

Does macOS UI automation support image-based element targeting?

Yes, macOS UI automation supports image-based targeting through the image command. This allows you to capture screens, identify UI elements visually, and drive input based on image recognition.

Why is my macOS UI automation not working or failing to click elements?

macOS UI automation may fail if Screen Recording and Accessibility permissions are not granted. Ensure these system permissions are enabled so the CLI can properly control windows, apps, and UI elements.