peekaboo

Automate macOS UI tasks with CLI commands for inspecting elements, clicking, typing, and managing apps.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/191854169/openclawFork --skill peekaboo-191854169
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/191854169/openclawFork/tree/main/skills/peekaboo
Command: npx skills add https://github.com/191854169/openclawFork --skill peekaboo-191854169

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture and automate macOS user interface tasks from the command line, reducing manual interactions and speeding up repetitive workflows.

Core Features & Use Cases

  • Full macOS UI automation CLI: inspect UI elements, drive input, launch and manage apps, and automate windows, menus, and dialogs across macOS.
  • Targeted interactions: click, type, scroll, hotkeys, and gestures with precise element targeting and optional delays.
  • Vision and debugging helpers: see annotated UI maps and visual feedback to verify automation flows.

Quick Start

Install Peekaboo and run a basic see followed by a 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 tasks from the command line?

You can automate macOS UI tasks from the command line by using a CLI to inspect elements, drive input, and manage apps. This approach speeds up repetitive workflows by capturing and executing routine user interface interactions directly.

What macOS permissions are required to run UI automation scripts?

Running UI automation scripts requires macOS Screen Recording and Accessibility permissions. You must grant these system privileges to your CLI environment so it can inspect interface elements, capture visual maps, and drive input across applications.

Can I inspect UI elements and drive input for macOS GUI testing?

Yes, you can inspect UI elements and drive input for macOS GUI testing. The CLI supports commands to see annotated UI maps, click, type, scroll, and trigger hotkeys with precise element targeting and optional delays to verify automation flows.

How do I script window and menu interactions across macOS apps?

You script window and menu interactions across macOS apps by executing CLI commands that launch and manage applications. This allows you to automate dialogs, navigate menus, and handle routine interface workflows without manual clicking.

What is the best way to debug macOS UI automation workflows?

The best way to debug macOS UI automation workflows is using vision and debugging helpers to see annotated UI maps. This provides visual feedback to verify automation flows, ensuring precise element targeting before executing click and type sequences.