peekaboo

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

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/sky770825/openclaw-console-hub --skill peekaboo-sky770825
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/sky770825/openclaw-console-hub/tree/main/openclaw-main/skills/peekaboo
Command: npx skills add https://github.com/sky770825/openclaw-console-hub --skill peekaboo-sky770825

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with macOS graphical user interfaces, enabling scripting of UI elements, application control, and screen capture.

Core Features & Use Cases

  • UI Automation: Interact with buttons, menus, and input fields across applications.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
  • Application Management: Launch, quit, and manage application windows and states.
  • Use Case: Automate the process of logging into a web application by scripting clicks and typing into form fields, then capturing a screenshot of the successful login.

Quick Start

Run peekaboo permissions to check and grant 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 can be scripted using the Peekaboo CLI to simulate clicks, type into input fields, and interact with buttons and menus across applications. This enables fully automated graphical interface workflows directly from terminal scripts.

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

Yes, screen capture and recording on macOS can be automated using the Peekaboo CLI. The tool supports capturing screenshots, recording screen activity, and analyzing visual content within scripting and automation workflows.

Do I need special permissions to run UI automation scripts on macOS?

Yes, macOS UI automation requires granting Screen Recording and Accessibility permissions. You can check and grant these necessary permissions by running the `peekaboo permissions` command before starting your automation scripts.

What's the best way to script application control and window management on macOS?

Scripting application control on macOS is handled by automating application launch, quit, and window state management. Using a CLI tool for UI automation provides precise element targeting and input simulation for managing apps.

Why is my macOS screen capture or UI automation script not working?

macOS UI automation fails when Screen Recording and Accessibility permissions are not granted. Running `peekaboo permissions` verifies and configures the required system access to resolve element targeting and input simulation issues.

Can I automate web application logins using macOS UI scripting?

Yes, web application logins can be automated on macOS by scripting clicks and typing into form fields. The automation workflow can also capture a screenshot of the successful login to verify the UI interaction.