peekaboo

Automate macOS UI interactions via command-line interface.

18|1|Updated Jun 12, 2026

Search Tags:#macos #scripting #ui automation #screen capture #mac automation

Ready to run

npx skills add https://github.com/vignesh2027/Vilvona-AI --skill peekaboo-vignesh2027

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/vignesh2027/Vilvona-AI/tree/main/skills/peekaboo
Command: npx skills add https://github.com/vignesh2027/Vilvona-AI --skill peekaboo-vignesh2027

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates macOS UI interactions, allowing users to capture, inspect, and control UI elements on their Macs without manual intervention.

Core Features & Use Cases

UI Automation: Capture screenshots, interact with UI elements, and drive input.
Scripting Support: Execute scripts for complex workflows.
Use Case: Imagine you need to automate a repetitive task like capturing screenshots of a user interface for documentation purposes. Peekaboo can be used to automate this process.

Quick Start

Capture a screenshot of the current window using Peekaboo:

peekaboo image --mode window

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 executing CLI commands that capture screenshots, inspect UI elements, and drive input without manual intervention. This allows you to script complex workflows and repetitive interface tasks directly from your terminal.

How do I capture a screenshot of a specific window using a macOS script?▼

To capture a screenshot of a window using a script, run the command `peekaboo image --mode window`. This automates the screen capture process for your interface, which is useful for generating documentation or monitoring visual changes.

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

Yes, UI automation scripts require permissions for screen recording and accessibility to function properly. You must grant these permissions to allow the command-line interface to capture screen content and drive input events on your macOS system.

What is the best way to inspect and interact with macOS UI elements for documentation?▼

The best way to inspect and interact with macOS UI elements for documentation is using a command-line automation tool. It can capture screenshots and control the interface automatically, eliminating repetitive manual tasks.

Can I execute complex scripting workflows that drive input on macOS?▼

Yes, you can execute scripts to drive input and automate complex workflows on macOS. The tool applies to macOS UI automation tasks, allowing you to interact with UI elements and execute multi-step processes without manual intervention.

Why does my macOS screen capture script fail to interact with the interface?▼

Your macOS screen capture script fails because it lacks the required permissions for screen recording and accessibility. You must explicitly grant these permissions in your system settings to allow the command-line interface to capture content and drive input.