peekaboo

Automate macOS UI interactions with a CLI for inspecting and controlling elements.

55|12|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/Yapie0/safe-openclaw --skill peekaboo-yapie0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Yapie0/safe-openclaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/Yapie0/safe-openclaw --skill peekaboo-yapie0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS UI automation to capture, inspect, and drive UI elements across apps and system dialogs, enabling repeatable interactions without manual clicks.

Core Features & Use Cases

  • Full macOS UI automation CLI that can inspect UI, capture screenshots, target UI elements, drive input, and manage apps, windows, menus, and dialogs.
  • Supports a snapshot cache, scripting with --json, and a range of commands (see, click, type, image, app, window, dock, menubar, etc.) for end-to-end automation and testing.
  • Use cases include UI regression testing, onboarding flows, and repetitive UI tasks across macOS apps.

Quick Start

Install Peekaboo and run a simple see, click, and type sequence to automate a UI task.

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 like clicking and typing across different apps?

You can automate macOS UI interactions by running a CLI with commands such as see, click, and type to capture, inspect, and drive UI elements across apps and system dialogs without manual input.

What is macOS UI automation used for in testing and onboarding flows?

macOS UI automation is used for UI regression testing, onboarding flows, and repetitive UI tasks, enabling repeatable interactions across applications by scripting element targeting and input control.

Do I need special macOS permissions for screen capture and UI automation?

Yes, you need to grant macOS permissions for Screen Recording and Accessibility to allow the CLI to capture screenshots, inspect UI elements, and drive input across system dialogs and apps.

Can I script macOS UI automation tasks using JSON?

Yes, you can script macOS UI automation tasks using the --json flag, which supports end-to-end automation and testing by structuring commands like see, click, and type into repeatable workflows.

What's the best way to inspect and target specific UI elements on macOS?

The best way to inspect and target macOS UI elements is using a CLI that supports a snapshot cache and commands like see, image, app, window, menu, and dock to capture and control specific elements.

Why is my macOS UI automation not working when trying to control system dialogs?

macOS UI automation fails to control system dialogs when Screen Recording and Accessibility permissions are not granted, preventing the CLI from inspecting and driving UI elements across apps.