peekaboo

Automate macOS UI interactions and system tasks via command-line interface.

455|34|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/understudy-ai/understudy --skill peekaboo-understudy-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/understudy-ai/understudy/tree/main/skills/peekaboo
Command: npx skills add https://github.com/understudy-ai/understudy --skill peekaboo-understudy-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with macOS graphical user interfaces, streamlining repetitive tasks and enabling programmatic control of applications.

Core Features & Use Cases

  • UI Element Interaction: Click, type, drag, and scroll through UI elements with precision.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
  • App & Window Management: Launch, quit, focus, and manipulate application windows.
  • Use Case: Automate the process of filling out a complex software registration form by having the agent sequentially click fields, type information, and submit the form.

Quick Start

Use the peekaboo skill to capture a screenshot of the frontmost application window.

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?

To automate macOS UI interactions from the command line, you use a CLI tool that programmatically controls applications, manages windows, and captures screens. This enables scripting repetitive desktop tasks and system workflows without manual input.

Do I need special permissions to script GUI automation on macOS?

Yes, scripting GUI automation on macOS requires granting Screen Recording and Accessibility permissions to the CLI tool. These macOS security permissions are necessary for the application to capture screen content and programmatically interact with UI elements.

Can I capture screenshots and analyze visual content during an automation script?

Yes, you can capture screenshots and analyze visual content during an automation script. The CLI tool supports screen capture functionality, allowing your scripts to record screen activity and extract visual data from applications for programmatic analysis.

What is the best way to automate filling out complex software registration forms on macOS?

The best way to automate filling out complex software registration forms on macOS is using a UI automation CLI. It can sequentially click input fields, type the required information, and submit the form programmatically, streamlining repetitive data entry workflows.

How does programmatic window management work for macOS applications?

Programmatic window management for macOS applications works by using a CLI to launch, quit, focus, and manipulate application windows. This allows scripts to control the desktop environment, arrange interfaces, and execute multi-app workflows automatically.