peekaboo

Automate macOS UI interactions via the Peekaboo CLI.

1|1|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/kelinfoxy/EZ-Homelab --skill peekaboo-kelinfoxy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/kelinfoxy/EZ-Homelab/tree/main/docker-compose/ez-assistant/skills/peekaboo
Command: npx skills add https://github.com/kelinfoxy/EZ-Homelab --skill peekaboo-kelinfoxy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo enables automated macOS UI interactions by controlling apps, windows, and UI elements from a single CLI, reducing manual UI testing and repetitive tasks.

Core Features & Use Cases

  • Automate UI tasks: see, click, type, capture, and manage windows and menus across macOS apps.
  • Script-driven UI automation for testing, accessibility checks, and workflow automation on macOS.
  • Use cases include UI exploration, automated testing of macOS apps, and rapid UI state capture for demos.

Quick Start

Install and run the Peekaboo CLI to begin automating macOS UI tasks.

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 using a CLI to control apps, windows, and UI elements. This approach enables script-driven input, element targeting, and screen capture for testing or workflow automation.

What do I need to set up before running macOS UI automation scripts?

Running macOS UI automation scripts requires a macOS environment with the Peekaboo binary installed and proper accessibility permissions granted. Installation is typically handled via Homebrew or a manual setup process.

Can I use macOS UI automation for testing Safari and Finder apps?

Yes, macOS UI automation can test Safari and Finder apps. The CLI supports seeing, clicking, typing, and managing windows and menus across these macOS applications for interactive tasks.

What is the best way to capture UI state for macOS app demos?

The best way to capture UI state for demos is using macOS UI automation to perform rapid screen captures. This script-driven approach automates element targeting and window management without manual intervention.

Why is my macOS UI automation script not clicking UI elements?

macOS UI automation scripts may fail to click UI elements if proper accessibility permissions are not granted to the CLI tool. Ensuring the Peekaboo binary is installed correctly via Homebrew is also required.