peekaboo

Automate macOS UI tasks with screen capture, element targeting, and input control.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/BEIRUX/agent-skills --skill peekaboo-beirux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/BEIRUX/agent-skills/tree/main/peekaboo
Command: npx skills add https://github.com/BEIRUX/agent-skills --skill peekaboo-beirux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS UI automation is often manual and error-prone. Peekaboo provides a single CLI to capture, inspect, target UI elements, drive input, and manage apps/windows/menus, enabling repeatable automation across macOS applications.

Core Features & Use Cases

  • Capture live UI state and inspect elements to identify targets
  • Drive input and control apps/windows/menus to automate common workflows
  • Share a snapshot cache and scriptable commands via JSON-based workflows for integration and testing

Quick Start

Install Peekaboo and run a quick workflow to inspect the screen, identify a target, and perform a click.

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 like screen capture and element targeting?

You can automate macOS UI tasks by using a CLI to capture live screen state, inspect elements, drive input, and control apps, windows, and menus. This enables repeatable workflows across macOS applications for testing and automation.

What is the best way to inspect UI elements for accessibility verification on macOS?

The best way to inspect UI elements for accessibility verification is capturing the live UI state and identifying targets through scriptable commands. This allows you to automate accessibility checks across macOS apps without manual inspection.

Can I integrate macOS UI automation into JSON-based testing workflows?

Yes, you can integrate macOS UI automation into JSON-based testing workflows. The CLI shares a snapshot cache and provides scriptable commands outputting JSON, enabling seamless integration with existing automated testing pipelines.

Does macOS UI automation require any specific dependencies or frameworks to run?

No specific dependencies or frameworks are required to run this macOS UI automation. The Skill operates independently without external component lists, allowing immediate setup for capturing screens and driving input.

How do I drive input and manage app windows during macOS automation testing?

You drive input and manage app windows by executing CLI commands that target specific UI elements. This directly controls application windows and menus, allowing you to automate common interaction workflows during testing.

Why does manual macOS UI testing produce errors and how can automation help?

Manual macOS UI testing produces errors due to human inconsistency in capturing states and targeting elements. Automation resolves this by providing a single CLI to drive input and inspect elements, ensuring repeatable and error-free workflows.