peekaboo

Automate macOS UI interactions, screen capture, and application management via CLI.

Updated Apr 20, 2026

Search Tags:#test automation #macos #ui automation #screenshot #ui inspection #system control

Ready to run

npx skills add https://github.com/silva2kand/silva-ide --skill peekaboo-silva2kand

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/silva2kand/silva-ide/tree/main/_cowork_os_pack/package/resources/skills/peekaboo
Command: npx skills add https://github.com/silva2kand/silva-ide --skill peekaboo-silva2kand

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Automates capturing and controlling macOS UI elements to simplify testing, accessibility checks, and UI workflows.

Core Features & Use Cases

UI Capture and Inspection: Take screenshots, analyze screen content, and identify UI elements for automation.
UI Interaction and Automation: Perform clicks, drag-and-drop, keyboard inputs, and window management to automate repetitive tasks.
Use Case: Automate the process of opening applications, navigating menus, and capturing UI states for testing or documentation purposes.

Quick Start

Use the peekaboo skill to list available apps, capture the screen, and interact with UI elements through simple commands.

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 a CLI toolset to script clicks, keyboard inputs, and window management. This allows you to automate repetitive tasks and complex workflows involving system controls and UI element targeting.

What is macOS UI inspection and how does it work for automation?▼

macOS UI inspection involves capturing screenshots and analyzing screen content to identify UI elements. This mechanism helps you target specific elements accurately to ensure effective operation during test automation and workflow scripting.

Do I need special permissions to capture screen content and manage applications on macOS?▼

Yes, you need to grant system permissions for screen recording and accessibility to capture screen content and manage applications. These permissions are required for the CLI to interact with the macOS UI effectively.

Can I use command line scripts to navigate menus and capture UI states for testing?▼

Yes, you can use command line scripts to open applications, navigate menus, and capture UI states. This is particularly useful for automating the process of capturing UI states for testing or documentation purposes.

What is the best way to perform drag-and-drop and window management via terminal commands?▼

The best way to perform drag-and-drop and window management via terminal commands is by using a CLI toolset designed for UI interaction. It enables scripting complex workflows that involve these specific UI interactions natively on macOS.

Why does my macOS UI automation tool fail to interact with UI elements?▼

macOS UI automation fails to interact with UI elements when screen recording and accessibility system permissions are not granted. Ensuring these specific system permissions are enabled resolves the issue and allows proper UI element targeting.