peekaboo

Automate macOS UI tasks using the Peekaboo CLI with see, click, and type commands.

Updated Dec 6, 2016
One-click install
npx skills add https://github.com/majunbao/learn --skill peekaboo-majunbao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/majunbao/learn/tree/main/openclaw_tags/openclaw-2026.3.2/skills/peekaboo
Command: npx skills add https://github.com/majunbao/learn --skill peekaboo-majunbao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture and automate macOS UI tasks using the Peekaboo CLI, reducing manual testing and repetitive UI work.

Core Features & Use Cases

  • Capture, inspect, and automate interactions with macOS UI elements across apps, windows, menus, and the Dock.
  • Drive input and automate sequences (see/click/type) to streamline UI testing, accessibility checks, and routine workflows.
  • Manage app/window state and provide scripting-friendly output for integration into CI or custom tooling.

Quick Start

Install Peekaboo and run a simple sequence such as see, click, and type to automate a 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 tasks using a CLI?

You can automate macOS UI tasks by using the Peekaboo CLI to capture, inspect, and interact with UI elements across apps and windows using see, click, and type commands.

What macOS permissions are required for UI automation scripting?

macOS UI automation scripting requires granting Screen Recording and Accessibility permissions to the Peekaboo binary to allow it to capture and interact with UI elements.

Can I integrate macOS UI testing scripts into CI pipelines?

Yes, you can integrate macOS UI testing into CI pipelines because Peekaboo supports scripting-friendly JSON output and verbose logging for custom tooling and automation workflows.

What is the best way to inspect and interact with macOS Dock and menu elements?

The best way to inspect and interact with macOS Dock and menu elements is using the Peekaboo CLI, which captures UI elements and drives input sequences across apps and windows.

Does Peekaboo support JSON output for automated UI workflows?

Yes, Peekaboo supports JSON output for automated UI workflows, allowing you to parse inspection results and manage app or window state within custom scripts and tooling.

Why is my macOS UI automation script not capturing screen elements?

macOS UI automation scripts fail to capture screen elements if the Peekaboo binary lacks the required Screen Recording and Accessibility permissions needed to function properly.