peekaboo

Automate macOS UI interactions via CLI commands for see, click, and type.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS UI automation often requires brittle scripts or manual steps; Peekaboo provides a straightforward CLI to inspect, target, and drive UI components for repeatable automation.

Core Features & Use Cases

  • Full UI automation toolkit: capture, target elements, click, type, and manage apps/windows.
  • Scriptable in automation flows; supports annotated targets for repeatable tasks.
  • Real-world use: automate repetitive UI interactions in macOS apps and GUI testing.

Quick Start

Run peekaboo see to identify targets, then use peekaboo click and peekaboo type to automate a simple macOS 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 from the command line?

To automate macOS UI interactions from the command line, you can use a CLI tool to inspect, target, and drive UI components like clicking and typing. This replaces brittle scripts with straightforward commands for repeatable task automation.

Do I need special permissions for macOS GUI testing automation?

Yes, macOS GUI testing automation requires granting Screen Recording and Accessibility permissions to the CLI tool. These macOS permissions are necessary for the automation commands to capture screen elements and drive UI interactions.

What's the best way to identify targets for repetitive UI automation on macOS?

The best way to identify targets for repetitive UI automation on macOS is using a see command to inspect the screen. This captures UI elements and supports annotated targets, ensuring your automation scripts interact with the correct components.

Can I script automated UI testing for macOS apps without writing complex code?

Yes, you can script automated UI testing for macOS apps without complex code by using straightforward CLI commands. The toolkit provides commands to capture, target elements, click, type, and manage apps or windows directly within your automation flows.

Why does my macOS UI automation script fail to click or type?

macOS UI automation scripts fail to click or type when the required Screen Recording and Accessibility permissions are not granted. You must enable these permissions in your macOS settings for the CLI to successfully drive UI components.