Peekaboo

Automate macOS UI interactions via command-line for screenshots, input, and app management.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/feiji77-2/openclaw --skill peekaboo-feiji77-2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Peekaboo
Source: https://github.com/feiji77-2/openclaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/feiji77-2/openclaw --skill peekaboo-feiji77-2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates repetitive tasks on macOS by providing a command-line interface to interact with the user interface, applications, and system elements.

Core Features & Use Cases

  • UI Automation: Capture screenshots, inspect UI elements, and drive input (clicks, typing, gestures).
  • Application Management: Launch, quit, and manage application windows.
  • System Interaction: Control menus, menubars, the Dock, and system dialogs.
  • Use Case: Automate the process of filling out a complex online form within a desktop application by using Peekaboo to navigate fields, input data, and submit the form.

Quick Start

Run the peekaboo command to check permissions for screen recording and accessibility.

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?

You can automate macOS UI interactions from the command line by using a CLI tool that targets UI elements, simulates input, and manages application windows. This requires granting Screen Recording and Accessibility permissions on your Mac.

Can I capture screenshots and simulate mouse clicks on macOS using a CLI script?

Yes, you can capture screenshots and simulate mouse clicks on macOS using a CLI script. The tool provides screen capture capabilities and drives input simulation including clicks, typing, and gestures for desktop applications.

Do I need special permissions to automate macOS application windows and system dialogs?

Yes, automating macOS application windows and system dialogs requires Screen Recording and Accessibility permissions. You can verify these permissions by running the core CLI command to check your system configuration before starting automation tasks.

What is the best way to automate filling out a complex form in a desktop application on macOS?

The best way to automate filling out a complex form in a desktop application on macOS is using a CLI scripting tool. It can programmatically navigate UI fields, input data sequentially, and submit the form without manual intervention.

Can I control macOS system elements like the menubar and Dock through terminal scripting?

Yes, you can control macOS system elements like the menubar and Dock through terminal scripting. The CLI tool supports system-level interactions including managing menus, menubars, the Dock, and handling system dialogs directly.

Does macOS UI automation work for launching and quitting applications automatically?

Yes, macOS UI automation works for launching and quitting applications automatically. The CLI tool provides comprehensive application management features, allowing you to start, stop, and manage application windows programmatically via scripts.