peekaboo

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

3|1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/gensparx/GenSparx --skill peekaboo-gensparx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/gensparx/GenSparx/tree/main/skills/peekaboo
Command: npx skills add https://github.com/gensparx/GenSparx --skill peekaboo-gensparx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with your macOS graphical user interface, allowing for precise control over applications, windows, and user input without manual intervention.

Core Features & Use Cases

  • UI Automation: Interact with UI elements, click buttons, type text, and execute menu commands.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
  • App & Window Management: Launch, quit, and manage application windows and their states.
  • Use Case: Automate the process of logging into a web application by opening the browser, navigating to the login page, filling in credentials, and submitting the form.

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?

You can automate macOS UI interactions from the command line by scripting application control, window management, and input simulation. This Skill enables precise execution of clicks, text typing, and menu commands without manual intervention.

What macOS permissions are required for GUI scripting and screen capture?

GUI scripting and screen capture on macOS require specific accessibility and screen recording permissions. These system-level privileges are necessary for the automation tool to read visual content and simulate user input across applications.

Can I capture a screenshot of a specific window and save it to a file path?

Yes, you can capture a screenshot of the frontmost window and save it directly to a specified file path like /tmp/screenshot.png. The tool targets specific application windows for precise screen capture and visual analysis.

How do I automate logging into a web application using macOS window management?

Automating a web application login involves opening the browser, navigating to the page, filling in credentials, and submitting the form. This is achieved through UI automation that simulates keyboard input and button clicks.

What is the best way to manage application windows and states on macOS?

The best way to manage application windows and states on macOS is through dedicated UI automation commands. You can programmatically launch, quit, and control application windows to streamline system tasks and workflow automation.

Does macOS UI automation work for analyzing visual content on the screen?

Yes, macOS UI automation supports analyzing visual content by capturing screenshots and recording screen activity. The tool provides advanced targeting capabilities to inspect and interact with on-screen graphical elements.