peekaboo

Automate macOS UI interactions via command-line interface for scripting workflows.

1|Updated Jan 28, 2026

Search Tags:#cli #macos #scripting #ui automation #gui #peekaboo

Ready to run

npx skills add https://github.com/lachlanchen/LazyingArtBot --skill peekaboo-lachlanchen

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/lachlanchen/LazyingArtBot/tree/main/skills/peekaboo
Command: npx skills add https://github.com/lachlanchen/LazyingArtBot --skill peekaboo-lachlanchen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with the macOS graphical user interface, enabling programmatic control over applications, windows, and user input.

Core Features & Use Cases

UI Automation: Capture screens, click elements, type text, and manage applications.
Scripting: Execute .peekaboo.json scripts for complex workflows.
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 peekaboo permissions to check your macOS 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?▼

Automate macOS UI interactions by using a CLI to capture screens, target elements, simulate input, and manage applications. This enables programmatic control over desktop workflows without manual intervention.

Do I need specific macOS permissions for screen capture and UI automation scripting?▼

Yes, macOS UI automation requires Screen Recording and Accessibility permissions. You can verify your system permissions by running the `peekaboo permissions` command before executing any scripts.

How do I script complex GUI automation workflows on Darwin operating systems?▼

Script complex GUI automation workflows on Darwin operating systems by executing `.peekaboo.json` files. These scripts orchestrate multiple UI interactions like navigating fields, inputting data, and submitting forms.

Can I automate filling out desktop application forms using UI automation?▼

Yes, you can automate filling out desktop application forms by combining screen capture, element targeting, and input simulation. This allows you to navigate fields, input data, and submit forms programmatically.

What are the limitations of using a CLI for macOS GUI automation?▼

CLI-based macOS GUI automation requires explicit Screen Recording and Accessibility permissions to function. Without these system-level privileges granted in macOS settings, element targeting and input simulation will fail.

What is the best way to manage applications and simulate user input on macOS?▼

The best way to manage applications and simulate input on macOS is through a dedicated CLI tool that supports various capture modes, interaction types, and system-level operations for workflow automation.