peekaboo

Automates macOS UI via command-line with targeting, input simulation, and screen management.

36|2|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/malue-ai/dazee-small --skill peekaboo-malue-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/malue-ai/dazee-small/tree/main/skills/library/peekaboo
Command: npx skills add https://github.com/malue-ai/dazee-small --skill peekaboo-malue-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a command-line interface for automating user interface interactions on macOS, enabling scripting of GUI tasks.

Core Features & Use Cases

  • UI Element Interaction: Click, type, drag, and scroll through UI elements.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
  • App & Window Management: Launch, quit, and manipulate applications and their windows.
  • Use Case: Automate the process of filling out a complex form in a desktop application by scripting clicks, text inputs, and window management.

Quick Start

Run peekaboo permissions to check and grant 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 from the command line?

macOS UI automation requires granting Screen Recording and Accessibility permissions before scripting GUI tasks. Run `peekaboo permissions` to check and grant the necessary macOS system access for UI element interaction and screen capture.

Can I script clicks and text input for a desktop application on macOS?

Yes, you can script clicks, text inputs, drags, and scrolls for desktop applications on macOS. The CLI targets specific UI elements to automate complex workflows like filling out forms within an application's graphical interface.

What is the best way to capture screenshots and record screen activity via CLI?

The best way to capture screenshots and record screen activity via CLI is using a macOS UI automation tool that supports screen capture and visual content analysis. This enables automated documentation of GUI interactions and visual testing.

Do I need special macOS permissions to run GUI automation scripts?

Yes, GUI automation scripts require Screen Recording and Accessibility permissions on macOS. These system-level permissions allow the CLI to capture screen content and simulate user input events like clicks and keystrokes across applications.

How does GUI scripting handle application and window management on macOS?

GUI scripting handles application and window management on macOS by launching, quitting, and manipulating applications through CLI commands. This allows scripts to control which apps are active and arrange their windows during automated task execution.