peekaboo

Automate macOS UI interactions and system tasks via command-line interface.

Updated Aug 27, 2026

Search Tags:#automation #ui #cli #macos #scripting #peekaboo

Ready to run

npx skills add https://github.com/xxrenzhe/autobb --skill peekaboo-xxrenzhe

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/xxrenzhe/autobb/tree/main/openclaw-prebuilt/skills/peekaboo
Command: npx skills add https://github.com/xxrenzhe/autobb --skill peekaboo-xxrenzhe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with the macOS user interface, allowing for programmatic control of applications, windows, and system elements.

Core Features & Use Cases

UI Element Interaction: Click, type, drag, and scroll through UI elements using various targeting methods.
Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
App & Window Management: Launch, quit, focus, and manipulate application windows.
Use Case: Automate the process of filling out a complex online form within a specific macOS application, including handling dialogs and ensuring correct input.

Quick Start

Use the peekaboo skill to capture a screenshot of the current screen and save it to /tmp/screenshot.png.

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 by using the Peekaboo CLI to script element targeting, input simulation, application control, and screen capture for deterministic workflows. It enables programmatic control over applications and system tasks directly from the terminal.

Do I need special macOS permissions to script UI elements and capture screenshots?▼

Yes, scripting UI elements and capturing screens requires granting specific macOS permissions. You must explicitly grant accessibility and screen recording permissions to the Peekaboo CLI tool before executing any automation workflows.

What's the best way to automate filling out a complex form in a macOS application?▼

The best way to automate complex form filling is using a CLI tool to target UI elements, simulate typing, and handle dialogs programmatically. This ensures correct input and deterministic workflows within specific macOS applications.

Can I capture and analyze screen activity programmatically on macOS?▼

Yes, you can capture and analyze screen activity programmatically on macOS. The Peekaboo CLI enables you to capture screenshots, record screen activity, and analyze visual content directly within your automated scripts.

How do I manage application windows when scripting macOS tasks?▼

You can manage application windows by using CLI commands to launch, quit, focus, and manipulate application states. This allows for precise control over window layouts and application focus during automated macOS workflows.

Why is my macOS UI automation script not triggering clicks or typing correctly?▼

macOS UI automation scripts fail to trigger clicks or typing when accessibility permissions are missing. Ensure the Peekaboo CLI tool has been explicitly granted accessibility permissions in your macOS system settings to simulate inputs correctly.