peekaboo

Automate macOS UI interactions and screen captures via a command-line interface.

2|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/FatBy/DD-OS --skill peekaboo-fatby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/FatBy/DD-OS/tree/main/skills/peekaboo
Command: npx skills add https://github.com/FatBy/DD-OS --skill peekaboo-fatby

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 scripting of UI actions like clicking, typing, and capturing screenshots.

Core Features & Use Cases

  • UI Interaction: Control applications, windows, menus, and system elements.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
  • Use Case: Automate the process of logging into a web application by having Peekaboo open a browser, navigate to the login page, type in credentials, and click the login button.

Quick Start

Run the peekaboo command to check permissions and list available applications.

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 using a CLI tool to simulate inputs, control applications, and navigate menus. This allows scripting of clicks, typing, and window management without a graphical interface.

Do I need special permissions to script GUI automation on macOS?

Yes, scripting GUI automation on macOS requires granting Screen Recording and Accessibility permissions to the CLI tool. These permissions are necessary for the application to capture screen content and simulate user input events.

Can I capture screenshots and record screen activity using a macOS CLI?

Yes, you can capture screenshots and record screen activity using a macOS automation CLI. The tool supports taking static screenshots and analyzing visual content directly from the command line for scripting purposes.

What is the best way to script application login workflows on macOS?

The best way to script application login workflows on macOS is using a UI automation CLI to open the browser, navigate to the login page, simulate typing credentials, and trigger the login button click automatically.

Does macOS UI automation work for managing system menus and windows?

Yes, macOS UI automation works for managing system menus and windows. The CLI tool supports direct application control, allowing scripts to navigate menus, manipulate window states, and interact with system elements programmatically.