peekaboo

Automate macOS UI interactions with screen capture, element targeting, and input simulation.

1|1|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/Rlier/clawdbot --skill peekaboo-rlier
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Rlier/clawdbot/tree/main/skills/peekaboo
Command: npx skills add https://github.com/Rlier/clawdbot --skill peekaboo-rlier

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 precise control over applications, windows, and user input without manual intervention.

Core Features & Use Cases

  • UI Automation: Capture screenshots, inspect UI elements, and drive mouse/keyboard input.
  • App & Window Management: Launch, quit, focus, and manipulate application windows.
  • Use Case: Automate the process of filling out a complex software installation wizard on macOS by programmatically clicking buttons, typing text, and selecting options.

Quick Start

Use peekaboo to capture a screenshot of the frontmost window and save it to your desktop.

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 like clicking buttons and typing text?

You can automate macOS UI interactions by using screen capture, element targeting, and input simulation to drive mouse and keyboard actions without manual intervention. This allows precise control over applications, windows, menus, and system dialogs.

Do I need specific macOS permissions for screen recording and accessibility automation?

Yes, automating macOS GUI interactions requires specific macOS permissions for screen recording and accessibility. These system permissions are mandatory to allow the automation tool to capture screen elements and simulate user input across applications.

Can I script complex application window management and system dialogs on macOS?

Yes, you can script application window management and system dialogs on macOS. The automation supports detailed control over applications, enabling you to launch, quit, focus, and manipulate application windows programmatically.

What is the best way to automate a software installation wizard on macOS?

The best way to automate a software installation wizard on macOS is by programmatically capturing screenshots, inspecting UI elements, and simulating mouse clicks and keyboard text input to navigate through the installation steps automatically.

How does screen capture and element targeting work for GUI automation?

Screen capture and element targeting for GUI automation work by inspecting the graphical user interface to identify specific visual elements. This allows the automation script to accurately locate buttons, menus, and input fields to simulate precise user interactions.

Why does my macOS UI automation script fail to interact with application menus?

macOS UI automation scripts fail to interact with application menus when the required accessibility and screen recording permissions are not granted. Without these system permissions, the automation cannot inspect UI elements or simulate input effectively.