skills.rest
johnson7788
johnson7788COMMUNITY
Explore all skills by this author →
GitHub

peekaboo

Automate macOS UI interactions via command-line with clicks and typing.

307|86|Updated Feb 12, 2026
Search Tags:#cli#macos#scripting#ui automation#peekaboo#gui control
One-click install
npx skills add https://github.com/johnson7788/MultiUserClaw --skill peekaboo-johnson7788
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/johnson7788/MultiUserClaw/tree/main/openclaw/skills/peekaboo
Command: npx skills add https://github.com/johnson7788/MultiUserClaw --skill peekaboo-johnson7788

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the control and interaction with the macOS graphical user interface, streamlining repetitive tasks and enabling programmatic UI manipulation.

Core Features & Use Cases

  • UI Automation: Capture screens, inspect UI elements, drive input (clicks, typing), and manage applications and windows.
  • Scripting: Execute .peekaboo.json scripts for complex automation sequences.
  • Use Case: Automate the process of filling out a complex software installation wizard by using Peekaboo to navigate through dialogs, enter text, and click buttons.

Quick Start

Use the peekaboo skill to capture a screenshot of the entire screen and save it to /tmp/screen.png.

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?▼

Automate macOS UI interactions by using a command-line interface to programmatically control applications, windows, menus, and user input like clicks and typing. This streamlines repetitive tasks and enables script-based GUI manipulation.

Do I need special permissions to control macOS applications via scripting?▼

Yes, controlling macOS applications via scripting requires Screen Recording and Accessibility permissions for full functionality. These system permissions allow the automation tool to capture screens and drive input events programmatically.

Can I script complex automation sequences for a macOS installation wizard?▼

Yes, you can script complex automation sequences for a macOS installation wizard by executing `.peekaboo.json` scripts. This allows you to navigate through dialogs, enter text, and click buttons programmatically.

How do I capture a screenshot of a macOS screen programmatically?▼

Capture a screenshot of a macOS screen programmatically by running a CLI command to grab the entire screen and save it to a specified file path like `/tmp/screen.png`. This enables automated screen inspection.

What is the best way to inspect UI elements and drive input on macOS?▼

The best way to inspect UI elements and drive input on macOS is using a dedicated CLI tool that captures screens, inspects elements, and manages applications. This approach enables reliable programmatic control over the graphical interface.

Why is my macOS UI automation not working during script execution?▼

macOS UI automation may not work during script execution if Screen Recording and Accessibility permissions are not granted. These system-level permissions are strictly required for the automation tool to interact with the graphical interface.

Related Skills

Explore More Software Engineering Skills→
wangqianCAIwangqianCAI

peekaboo

Automate macOS UI interactions via accessibility and screen recording APIs.

Community
Advanced
vignesh2027vignesh2027
18

peekaboo

Automate macOS UI interactions via command-line interface.

Community
Advanced
hoainam183hoainam183

tmux

Manage persistent tmux sessions, windows, and panes via shell scripts.

Community
Intermediate
paxlabs-incpaxlabs-inc
7

computer-use

Simulate user input and capture visual state across macOS, Windows, and Linux.

Community
Advanced