peekaboo

Automate macOS UI interactions and screen capture via the Peekaboo CLI.

34|1|Updated Feb 20, 2026

Search Tags:#automation #ui #cli #macos #gui #screen capture

Ready to run

npx skills add https://github.com/mangiapanejohn-dev/Resonix-AG --skill peekaboo-mangiapanejohn-dev

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/mangiapanejohn-dev/Resonix-AG/tree/main/skills/peekaboo
Command: npx skills add https://github.com/mangiapanejohn-dev/Resonix-AG --skill peekaboo-mangiapanejohn-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with the macOS graphical user interface, allowing for programmatic control of applications, windows, and user input.

Core Features & Use Cases

UI Element Interaction: Click, type, drag, and scroll through UI elements.
Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
Application & Window Management: Launch, quit, and manage application windows.
Use Case: Automate the process of filling out a complex online form within a desktop application, including navigating through multiple windows and dialogs.

Quick Start

Use the peekaboo skill to capture a screenshot of the frontmost window and save it to /tmp/screenshot.png.

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?▼

Automating macOS UI from the command line involves using a CLI to simulate user inputs like clicks and typing, manage application windows, and capture screenshots for scripting complex desktop workflows.

Can I capture a screenshot of a specific window using a CLI on macOS?▼

Yes, capturing a screenshot of a specific macOS window via CLI is supported. You can target the frontmost window, record screen activity, and save the visual output to a designated file path like /tmp/screenshot.png.

Do I need special permissions to automate screen capture and UI interactions on macOS?▼

Yes, you need Screen Recording and Accessibility permissions to automate screen capture and UI interactions on macOS. These system permissions allow the CLI tool to read screen content and simulate user input effectively.

What is the best way to script complex desktop application form filling on macOS?▼

Scripting complex form filling on macOS is best handled by a UI automation CLI that targets specific UI elements. It simulates typing and clicking to navigate through multiple windows and dialogs within desktop applications.

How does element targeting work for macOS GUI automation?▼

Element targeting in macOS GUI automation identifies specific interface components like buttons and text fields within an application. This allows the CLI to execute precise input simulation and window management actions during scripting.

Are there limitations when automating macOS applications with a CLI?▼

A primary limitation of automating macOS applications with a CLI is the dependency on Screen Recording and Accessibility permissions. Without these explicit system grants, the automation tool cannot perform element targeting, input simulation, or visual analysis.