peekaboo

Automate macOS UI interactions and capture screen content via the Peekaboo CLI.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/badbsallyy/openclaw-source-code --skill peekaboo-badbsallyy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/badbsallyy/openclaw-source-code/tree/main/openclaw-sourcecode.zip/skills/peekaboo
Command: npx skills add https://github.com/badbsallyy/openclaw-source-code --skill peekaboo-badbsallyy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the capture, inspection, and interaction with the macOS user interface, streamlining repetitive tasks and enabling programmatic control of applications and system elements.

Core Features & Use Cases

  • UI Capture & Inspection: Capture screenshots, record screen activity, and inspect UI elements for automation.
  • Interaction: Drive mouse clicks, keyboard input, gestures, and application commands.
  • Use Case: Automate the process of logging into a web application by capturing the login screen, identifying input fields, typing credentials, and clicking the login button.

Quick Start

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

Automating macOS UI interactions from the command line involves using a CLI tool to simulate mouse clicks, keyboard input, and application commands. This Skill leverages the Peekaboo CLI to drive these interface elements programmatically for scripting workflows.

What macOS permissions are required for screen capture and UI automation?

Screen capture and UI automation on macOS require explicit Screen Recording and Accessibility permissions. You can verify your system's authorization status by running the `peekaboo permissions` command before executing your automation scripts.

Can I script automated logins for web applications using macOS UI automation?

Yes, you can script automated logins for web applications using macOS UI automation. The workflow involves capturing the login screen, targeting the input fields, simulating keyboard input for credentials, and programmatically clicking the login button.

Does this CLI tool support screen recording and UI element inspection?

Yes, the CLI tool supports screen recording and UI element inspection. It enables you to capture screenshots, record screen activity, and inspect UI elements to streamline repetitive tasks and build robust automation workflows.

What are the limitations of using CLI-based mouse control and keyboard input on macOS?

Limitations of using CLI-based mouse control and keyboard input on macOS primarily involve system permission blocks. If Screen Recording or Accessibility access is denied, the UI automation, screen capture, and interaction simulation commands will fail to execute.