peekaboo

Automate macOS UI tasks with Peekaboo CLI for capture, input, and app management.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/qkal/superbyte --skill peekaboo-qkal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/qkal/superbyte/tree/main/skills/peekaboo
Command: npx skills add https://github.com/qkal/superbyte --skill peekaboo-qkal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo provides a macOS UI automation CLI to reduce tedious manual testing by enabling scripted control over screen capture, UI element targeting, input, and window/app management.

Core Features & Use Cases

  • Capture and inspect screens, target UI elements, drive input, and manage apps/windows/menus.
  • Share a snapshot cache and support --json/-j for scripting and automation workflows.
  • Run commands with helpful flags and version metadata; integrate into CI and local automation.

Quick Start

Install the Peekaboo CLI and run a basic command to verify that the setup works.

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?

You can automate macOS UI tasks using a CLI to capture screens, target UI elements, and drive input for automation workflows. This provides scripted control over window and app management without manual intervention.

Can I capture screens and target UI elements for testing on macOS?

Yes, you can capture screens and target UI elements for testing on macOS. The CLI supports screen inspection, UI element targeting, and input driving to reduce manual testing efforts.

Do I need any specific software installed to run macOS UI automation scripts?

You need a macOS system with the Peekaboo binary installed to run UI automation scripts. The CLI relies on this binary to execute commands for capture, click, type, and app management.

Does macOS UI automation support JSON output for CI integration?

Yes, macOS UI automation supports JSON output using the --json or -j flags. This enables scripting and automation workflows to parse command results easily for CI and local automation integration.

What is the best way to manage apps and windows during automated macOS testing?

The best way to manage apps and windows during automated macOS testing is using CLI commands designed for app management. These commands allow scripts to control windows, menus, and input programmatically.

Are there limitations when using CLI tools for macOS UI automation?

A key limitation of using CLI tools for macOS UI automation is the strict requirement for a macOS environment with the specific binary installed. It cannot execute automation workflows on non-macOS systems.