peekaboo

Name: peekaboo
Availability: InStock
Author: liutao96

Automate macOS UI interactions with the Peekaboo CLI.

Updated Feb 14, 2026

Search Tags:#macos #window-management #peekaboo #screen-capture #ui-automation #automation-cli #element-targeting

Ready to run

npx skills add https://github.com/liutao96/skill --skill peekaboo-liutao96

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo automates macOS UI tasks such as capturing screens, targeting UI elements, driving input, and managing apps/windows, reducing tedious manual work.

Core Features & Use Cases

Screen capture and inspection of macOS UI
Targeting UI elements and performing input actions (click, type, hotkeys)
Window, app, and dock/menubar management for automated workflows
Snapshot visualization and scripting support

Quick Start

Start by granting the required permissions and running the see command to identify UI targets.

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 and capture screens from the command line?▼

You can automate macOS UI interactions by running CLI commands to capture screens, target UI elements, and drive inputs. This requires granting Accessibility and Screen Recording privileges to the automation tool.

Can I identify and target specific UI elements on macOS for automated clicking and typing?▼

Yes, you can identify UI targets by running the see command to inspect the screen. Once identified, you can automate input actions like clicking, typing, and triggering hotkeys on those specific UI elements.

What macOS permissions are required to control windows and manage apps via an automation CLI?▼

To control windows and manage apps via an automation CLI, you need to grant macOS Accessibility and Screen Recording privileges. These permissions allow the tool to capture screen content and drive system inputs.

What is the best way to manage dock and menubar interactions in a macOS automation workflow?▼

The best way to manage dock and menubar interactions is using a CLI automation tool that supports window, app, and dock/menubar management. This reduces manual work by scripting these actions into automated workflows.

Does macOS UI automation work for scripting app windows and taking snapshot visualizations?▼

Yes, macOS UI automation supports scripting app windows and taking snapshot visualizations. You can capture screen states and use scripting support to automate repetitive window management and inspection tasks.

Why does my macOS automation CLI fail to capture screens or drive input?▼

macOS automation CLIs fail to capture screens or drive input when lacking necessary privileges. You must explicitly grant Accessibility and Screen Recording permissions to the binary in macOS security settings before executing commands.