peekaboo

Automate macOS UI interactions and capture screens via command line.

375|38|Updated Dec 2, 2025
One-click install
npx skills add https://github.com/CraftOS-dev/CraftBot --skill peekaboo-craftos-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/CraftOS-dev/CraftBot/tree/main/skills/peekaboo
Command: npx skills add https://github.com/CraftOS-dev/CraftBot --skill peekaboo-craftos-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with macOS graphical user interfaces, allowing for programmatic control of applications, windows, and user input.

Core Features & Use Cases

  • UI Automation: Control clicks, typing, drags, and other interactions with UI elements.
  • Screen Capture & Analysis: Capture screenshots and analyze visual content.
  • App & Window Management: Launch, quit, and manage applications and their windows.
  • Use Case: Automate the repetitive task of filling out a complex form within a desktop application, or script a series of UI interactions for testing purposes.

Quick Start

Run peekaboo permissions 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?

To automate macOS UI interactions via a CLI, you use a tool that supports element targeting, input simulation, and visual analysis. This allows you to script repetitive tasks like form filling and application testing directly from the terminal.

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

Yes, scripting screen capture and GUI automation on macOS requires granting Screen Recording and Accessibility permissions. You can verify and request these necessary system permissions by running a dedicated permissions check command.

Can I capture macOS screenshots and analyze visual content for automation scripts?

Yes, you can capture macOS screenshots and analyze visual content within your automation scripts. This visual analysis capability enables dynamic element targeting and verification during complex GUI automation workflows.

What is the best way to script repetitive desktop application tasks on macOS?

The best way to script repetitive desktop application tasks on macOS is using a CLI tool designed for GUI automation. It enables programmatic control over applications, windows, and user input to automate complex workflows like form submissions.

Does this CLI tool support app and window management for macOS scripting?

Yes, the CLI tool supports app and window management for macOS scripting. You can programmatically launch, quit, and manage applications alongside simulating user input to create comprehensive UI automation sequences.