peekaboo

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

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

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 elements, application control, and screen capture.

Core Features & Use Cases

  • UI Element Interaction: Click, type, drag, and scroll through UI elements using robust targeting.
  • Application & Window Management: Launch, quit, focus, and manipulate application windows.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
  • Use Case: Automate the process of logging into a desktop application by scripting clicks and text input into the login fields, then capturing a screenshot to confirm successful login.

Quick Start

Run peekaboo permissions to check 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 via CLI lets you script clicks, typing, and window management. This Skill provides element targeting, input simulation, and application control to automate desktop workflows without manual interaction.

Can I capture screenshots and record screen activity on macOS through a script?

Screen capture and recording can be scripted by automating macOS UI elements. This Skill supports capturing screenshots and recording screen activity, then analyzing visual content to confirm automated actions like successful logins.

What macOS permissions do I need for UI automation and screen capture?

UI automation on macOS requires specific permissions for screen recording and accessibility. You can run `peekaboo permissions` to check whether your system has the necessary access rights configured for scripting UI interactions.

How do I script clicking and typing into application login fields on macOS?

Scripting clicks and text input into application fields is done by targeting UI elements. This Skill automates the login process by simulating mouse clicks on fields, typing credentials, and capturing a screenshot to verify successful authentication.

Does this CLI tool work for automating application window management on macOS?

Application window management on macOS is supported through CLI commands. You can launch, quit, focus, and manipulate application windows as part of your scripting and automation workflows, enabling full control over desktop applications.

What's the best way to check if my macOS environment is ready for UI automation?

Checking macOS readiness for UI automation involves verifying screen recording and accessibility permissions. Running `peekaboo permissions` inspects your system configuration and reports whether the required access rights are granted for automation.