peekaboo

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates tedious macOS user interface interactions, enabling scripting and programmatic control over applications and system elements.

Core Features & Use Cases

  • UI Automation: Control clicks, typing, drags, and gestures across applications.
  • Screen Capture & Analysis: Capture screenshots, record screen regions, and analyze UI elements.
  • App & Window Management: Launch, quit, and manipulate application windows and system dialogs.
  • Use Case: Automate the process of logging into a web application by having Peekaboo open the browser, navigate to the login page, fill in credentials, and submit the form.

Quick Start

Run the peekaboo permissions command to check necessary macOS permissions.

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?

Screen capture on macOS via CLI scripting allows you to take screenshots, record screen regions, and perform visual analysis on UI elements for automated testing and workflows.

Do I need special permissions to script macOS UI automation?

Scripting macOS UI automation requires granting Screen Recording and Accessibility permissions to your terminal or automation tool to enable full element targeting and input simulation control.

What is the best way to automate logging into a web application on macOS?

Automating web application logins on macOS is best handled by scripting the process: open the browser, navigate to the login page, fill in credentials, and submit the form programmatically.

Can I manage application windows and system dialogs through macOS scripting?

Yes, macOS scripting allows you to manage application windows and system dialogs by programmatically launching, quitting, and manipulating app windows during automation tasks.

Why is my macOS UI automation script not triggering clicks or capturing the screen?

macOS UI automation scripts fail to trigger clicks or capture screens when the executing environment lacks Screen Recording and Accessibility permissions, which are required for full functionality.