skills.rest
syxscott
syxscottCOMMUNITY
Explore all skills by this author →
GitHub

peekaboo

Automate macOS UI interactions via command-line screen capture and input simulation.

1|Updated Mar 8, 2026
Search Tags:#automation#cli#macos#scripting#ui testing#screen capture
One-click install
npx skills add https://github.com/syxscott/PaleoClaw --skill peekaboo-syxscott
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/syxscott/PaleoClaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/syxscott/PaleoClaw --skill peekaboo-syxscott

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive command-line interface for automating virtually any aspect of the macOS user interface, from capturing screens to interacting with applications and system elements.

Core Features & Use Cases

  • UI Automation: Control applications, windows, menus, and system dialogs.
  • Screen Capture & Analysis: Capture screenshots, record video, and analyze UI elements visually.
  • Input Simulation: Simulate mouse clicks, drags, scrolls, key presses, and hotkeys.
  • Use Case: Automate the process of filling out a complex web form within a desktop application by using peekaboo to navigate fields, type data, and click buttons.

Quick Start

Run peekaboo permissions to ensure the necessary macOS permissions are granted for UI automation.

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 simulates mouse clicks, key presses, and manages windows and menus. This approach allows you to script complex desktop application workflows without a graphical interface.

Do I need special permissions to run macOS UI automation scripts?▼

Yes, macOS UI automation requires granting Screen Recording and Accessibility permissions to the tool. You must explicitly authorize these security settings in your system preferences before executing any input simulation or screen capture commands.

Can I capture screenshots and record video of macOS applications via CLI?▼

Yes, you can capture screenshots and record video of macOS applications via CLI. The tool supports screen capture and visual analysis of UI elements, enabling automated visual testing and documentation directly from terminal scripts.

What is the best way to script filling out a complex desktop application form?▼

The best way to script filling out a complex desktop application form is using a CLI tool that simulates input. It can programmatically navigate form fields, type data, and click buttons, automating the entire interaction sequence without manual input.

How do I inspect and interact with macOS system dialogs programmatically?▼

You can inspect and interact with macOS system dialogs programmatically by executing CLI commands that target application menus and system elements. This allows scripts to manage windows, trigger menu items, and handle system dialog responses automatically.

Related Skills

Explore More Software Engineering Skills→
coltonbattscoltonbatts

peekaboo

Automate macOS UI interactions via command-line interface.

Community
Advanced
47thtechcorner47thtechcorner
21

playwright-recording

Record browser interactions into video files using Playwright and FFmpeg.

Community
Advanced
Prathmesh234Prathmesh234

app-launcher

Launch and manage desktop applications and windows on Windows and Linux.

Community
Intermediate
altic-devaltic-dev
129

altic-studio

Automates macOS apps via AppleScript/osascript and Chrome via MCP CDP screenshots and page interactions.

Community
Advanced