skills.rest
UselessXu
UselessXuCOMMUNITY
Explore all skills by this author →
GitHub

peekaboo

Automate macOS UI interactions via the Peekaboo CLI.

Updated Mar 4, 2026
Search Tags:#macos#command-line#peekaboo#screen-capture#automation-scripting#ui-automation#element-targeting
One-click install
npx skills add https://github.com/UselessXu/mino --skill peekaboo-uselessxu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/UselessXu/mino/tree/main/.claude/skills/peekaboo
Command: npx skills add https://github.com/UselessXu/mino --skill peekaboo-uselessxu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This solution eliminates the tedious manual work of controlling macOS applications, capturing UI, and simulating user input by providing a single CLI to automate repetitive UI tasks.

Core Features & Use Cases

  • Capture live screens, inspect targets, and drive input across apps/windows/menus.
  • Locate UI elements by IDs, titles, or coordinates and perform actions like click, type, and scroll.
  • Automate UI testing, scripting, and routine workflows across macOS apps with repeatable, auditable runs.

Quick Start

Install Peekaboo, grant required accessibility permissions, and begin automating macOS UI with commands like peekaboo see, peekaboo click, and peekaboo type.

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 tasks from the command line?▼

macOS UI automation from the command line is done by capturing screens, targeting UI elements by IDs or coordinates, and driving input like clicks and typing. This eliminates repetitive manual control across applications and windows.

Can I locate and interact with macOS UI elements using a CLI?▼

Yes, you can locate macOS UI elements using identifiers, titles, or coordinates, then perform actions like click, type, and scroll. This enables repeatable and auditable workflow automation across multiple apps.

What macOS permissions are required to automate UI interactions?▼

Automating macOS UI interactions requires granting accessibility permissions to the CLI tool. The solution verifies these required permissions at runtime to ensure scripts can drive input and capture screens properly.

How does screen capture and element targeting work for macOS automation?▼

Screen capture and element targeting work by inspecting live screens and matching UI elements by their IDs, titles, or coordinates. This allows automation scripts to verify targets before simulating user input like clicks and typing.

What's the best way to automate repetitive macOS window and menu workflows?▼

The best way to automate repetitive macOS workflows is by using modular CLI commands to control apps, windows, menus, and docks. This provides repeatable, scriptable runs for UI testing and routine tasks.

Are there limitations when scripting macOS UI automation for multiple applications?▼

Limitations when scripting macOS UI automation involve ensuring all targeted applications have granted accessibility permissions. Scripts rely on accurate element targeting, so dynamic or unidentifiable UI components may cause automation failures.

Related Skills

Explore More Software Engineering Skills→
kelinfoxykelinfoxy
1

peekaboo

Automate macOS UI interactions via the Peekaboo CLI.

Community
Advanced
anhtesteranhtester
129

Flaky Test Analyzer

Analyze intermittent test failures and propose remediation steps.

Community
Intermediate
DingTalk-Real-AIDingTalk-Real-AI
2.1k

dws-cli

Script DingTalk operations and batch-manage organizational data via CLI commands.

Official
Intermediate
mikeyobrienmikeyobrien
369

notification

Display native macOS notifications with title, message, and optional sound.

Community
Basic