peekaboo

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

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/hummbl-dev/hummbl-agent --skill peekaboo-hummbl-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/hummbl-dev/hummbl-agent/tree/main/skills/peekaboo
Command: npx skills add https://github.com/hummbl-dev/hummbl-agent --skill peekaboo-hummbl-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates tedious 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 identified by various selectors.
  • Application & Window Management: Launch, quit, focus, and manipulate application windows.
  • Screen Capture & Analysis: Capture screenshots and analyze visual content for automation triggers.
  • Use Case: Automate the process of filling out a complex multi-step form in a desktop application, including navigating between fields, entering data, and clicking buttons.

Quick Start

Run the peekaboo skill to check permissions for screen recording and accessibility.

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

You can automate macOS UI interactions programmatically by targeting elements with selectors to simulate clicks, typing, dragging, and scrolling, while managing application windows directly from scripts.

Can I capture screenshots and analyze visual content during macOS automation?

Yes, you can capture screenshots and analyze visual content during macOS automation workflows to trigger subsequent actions based on what is visually displayed on the screen.

Do I need special permissions to automate GUI tasks on macOS?

Yes, automating GUI tasks on macOS requires granting Screen Recording and Accessibility permissions to allow programmatic control of applications and screen captures.

What's the best way to automate filling out a complex multi-step form in a desktop application?

The best way to automate multi-step form filling in desktop applications is by simulating input to navigate between fields, entering data programmatically, and clicking buttons through UI element targeting.

How does application and window management work for macOS scripting?

Application and window management for macOS scripting allows you to programmatically launch, quit, focus, and manipulate application windows within your automation workflows.

Why is my macOS UI automation not working properly?

macOS UI automation may not work properly if Screen Recording and Accessibility permissions are not granted, which are required for programmatic application control and input simulation.