skills.rest
stevengonsalvez
stevengonsalvezCOMMUNITY
Explore all skills by this author →
GitHub

peekaboo

Automate macOS UI tasks by scripting the Peekaboo CLI to interact with apps, windows, and UI elements.

Updated Apr 10, 2026
Search Tags:#automation#accessibility#cli#macos#screen-recording#peekaboo#ui-automation
One-click install
npx skills add https://github.com/stevengonsalvez/nanoclaw-standalone --skill peekaboo-stevengonsalvez
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/stevengonsalvez/nanoclaw-standalone/tree/main/container/skills/peekaboo
Command: npx skills add https://github.com/stevengonsalvez/nanoclaw-standalone --skill peekaboo-stevengonsalvez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

MacOS UI automation can be tedious and error-prone when done manually; Peekaboo provides a CLI to reliably inspect, target, and drive UI elements across macOS apps in a secure, container-backed environment.

Core Features & Use Cases

  • Inspect and target UI elements across macOS apps using a uniform CLI interface.
  • Script common workflows to launch apps, interact with windows, menus, and dialogs, and verify results.
  • Manage app lifecycle and interactions in a controlled environment with built-in safety checks and permissions handling.

Quick Start

Install Peekaboo, grant Screen Recording and Accessibility permissions, and run a quick see followed by a click workflow to automate a UI task.

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 tasks from the command line?▼

MacOS UI automation is handled by scripting the Peekaboo CLI to interact with apps, windows, and UI elements. It reliably inspects, targets, and drives UI components in a secure, container-backed environment.

What permissions do I need to run macOS screen recording and UI automation scripts?▼

Running macOS UI automation scripts requires granting Screen Recording and Accessibility permissions to the Peekaboo binary. The environment includes built-in safety checks and permissions handling for controlling app interactions.

Can I script macOS app workflows to launch apps and interact with dialogs?▼

Yes, you can script workflows to launch apps, interact with windows, menus, and dialogs, and verify results. The Peekaboo CLI provides a uniform interface for simulating input and managing the app lifecycle.

How do I inspect and target UI elements across macOS apps?▼

You inspect and target UI elements across macOS apps using a uniform CLI interface. This enables you to capture visuals and simulate input accurately within a controlled, isolated environment.

What is the best way to manage app lifecycle in an isolated macOS environment?▼

Managing app lifecycle in an isolated macOS environment is achieved using a container-backed approach with built-in safety checks. Peekaboo handles permissions and interactions securely to ensure reliable UI automation.

Related Skills

Explore More Software Engineering Skills→
steipetesteipete
385.7k

peekaboo

Capture and control macOS UI elements via CLI commands.

Community
Advanced
solace-illsolace-ill

test-flakiness

Analyze CI logs and JUnit/XML results to detect flaky tests.

Community
Intermediate
HCMUTE-RTICHCMUTE-RTIC

bash-pro

Write defensive Bash scripts with strict error handling and input validation.

Official
Advanced
mikeyobrienmikeyobrien
369

notification

Display native macOS notifications with title, message, and optional sound.

Community
Basic