peekaboo

Automates macOS UI interactions and screen captures via the Peekaboo CLI tool.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/loveoplay2023-hue/OpenMehdi --skill peekaboo-loveoplay2023-hue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/loveoplay2023-hue/OpenMehdi/tree/main/skills/peekaboo
Command: npx skills add https://github.com/loveoplay2023-hue/OpenMehdi --skill peekaboo-loveoplay2023-hue

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: Target and interact with UI elements (buttons, text fields, etc.) using various methods like clicks, typing, and drags.
  • Screen Capture & Analysis: Capture screenshots of the screen, windows, or specific regions, with options for visual analysis.
  • Use Case: Automate the process of logging into a web application by having Peekaboo type the username and password into the respective fields and click the login button.

Quick Start

Use the peekaboo skill to capture a screenshot of the entire screen and save it to /tmp/screen.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 by using a CLI tool to target elements, simulate inputs like clicks and typing, and manage windows programmatically. This allows script-based control over graphical applications.

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

Yes, you can capture screenshots of the entire screen, specific windows, or defined regions and save them directly to a designated file path like /tmp/screen.png for visual analysis or logging.

What macOS permissions are required to run GUI testing and screen capture scripts?

To perform GUI testing and screen capture on macOS, you must grant Screen Recording and Accessibility permissions to the terminal or automation tool, allowing it to control UI elements and record the display.

How do I automate logging into a web application by simulating user input on macOS?

Automate web application logins by targeting the username and password text fields, simulating keyboard typing to enter credentials, and programmatically triggering a click on the login button.

Does this tool support visual analysis of captured screen regions for UI testing?

Yes, the tool supports visual analysis alongside screen capture, allowing you to capture specific regions of the screen and process the visual output for automated UI testing and verification tasks.