skills.rest
lachlanchen
lachlanchenCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/lachlanchen/LazyingArtBot --skill peekaboo-lachlanchen
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
JansenAnalyticsJansenAnalytics
5

peekaboo

Automate macOS UI interactions with a CLI tool requiring Screen Recording and Accessibility permissions.

Community
Advanced
openxjarvisopenxjarvis
67

peekaboo

Automate macOS UI interactions and screen captures via command-line interface.

Community
Advanced
pmarashianpmarashian
2

cross-platform-timeout

Execute shell commands with a time limit across operating systems.

Community
Basic
pmcdowallpmcdowall

macos-computer-use

Control macOS desktop interfaces without stealing user input focus.

Community
Advanced