skills.rest
hammadparveez
hammadparveezCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

peekaboo

Automate macOS UI interactions and screen captures with the Peekaboo CLI tool.

Updated Mar 3, 2026
Search Tags:#cli#macos#scripting#ui automation#gui#peekaboo
One-click install
npx skills add https://github.com/hammadparveez/mrhammadclaw --skill peekaboo-hammadparveez
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/hammadparveez/mrhammadclaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/hammadparveez/mrhammadclaw --skill peekaboo-hammadparveez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with the macOS graphical user interface, enabling programmatic control over applications, windows, and user input.

Core Features & Use Cases

  • UI Automation: Control apps, windows, menus, and UI elements.
  • Input Simulation: Simulate clicks, typing, hotkeys, and gestures.
  • Screen Capture & Analysis: Capture screenshots and analyze UI content.
  • Use Case: Automate the process of filling out a complex form in a desktop application by using Peekaboo to navigate fields, type data, and click buttons.

Quick Start

Run peekaboo permissions to check necessary macOS permissions for UI automation.

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 and simulate user input programmatically?▼

You can automate macOS UI interactions by using this tool to launch applications, manage windows, and simulate clicks, typing, and hotkeys. It enables programmatic control over desktop applications and graphical interfaces.

Do I need special macOS permissions to run GUI automation scripts and capture screens?▼

Yes, macOS GUI automation and screen capturing require explicit Screen Recording and Accessibility permissions. You can verify your system's authorization status by running the `peekaboo permissions` command before executing any automation scripts.

Can I capture specific screen regions and analyze UI content on a full desktop?▼

Yes, you can capture both specific screen regions and full desktops to analyze UI content. The tool allows you to programmatically take screenshots of the macOS environment and extract visual information from the captured graphical user interface.

What is the best way to automate filling out a complex form in a desktop application?▼

The best way to automate filling out a complex desktop form is to use UI automation to programmatically navigate fields, type data, and click buttons. This simulates human interaction with the graphical interface to complete the input process reliably.

Why is my macOS UI automation script not working or failing to control applications?▼

macOS UI automation fails when the necessary Screen Recording and Accessibility permissions are not granted to the controlling process. Running the `peekaboo permissions` diagnostic command helps identify and resolve these missing system authorizations.

Related Skills

Explore More Software Engineering Skills→
xg-gh-25xg-gh-25
36

peekaboo

Capture screens, identify UI elements, and automate clicks and typing in macOS apps.

Community
Advanced
nedosnedos
8

winuse

Control Windows desktops via REST API for screenshots and input.

Community
Intermediate
RachasumanthRachasumanth

peekaboo

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

Community
Advanced
InverterNetworkInverterNetwork

computer-use

Control native desktop applications in the background across macOS, Windows, and Linux.

Official
Advanced