peekaboo

Automate macOS UI interactions via the Peekaboo CLI.

Updated Mar 11, 2026
One-click install
npx skills add https://github.com/ISAQQSAI/SkillAttack --skill peekaboo-isaqqsai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/ISAQQSAI/SkillAttack/tree/main/data/hot100skills/020_steipete_peekaboo
Command: npx skills add https://github.com/ISAQQSAI/SkillAttack --skill peekaboo-isaqqsai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates repetitive macOS UI interactions to reduce manual testing and UI automation effort.

Core Features & Use Cases

  • Full macOS UI automation CLI to inspect UI, target elements, drive input, and manage apps/windows/menus.
  • Commands share a snapshot cache and support --json for scripting; run peekaboo or peekaboo <cmd> for flags; peekaboo --version prints build metadata.
  • Tip: run via polter peekaboo to ensure fresh builds.
  • See also: capture, click, type, and see workflows to automate end-to-end tasks.

Quick Start

Install Peekaboo and run a basic see and click workflow to automate a simple UI task.

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 from the command line using a CLI tool that controls UI elements, windows, and input. It enables repeatable interactions like listing apps, capturing UI state, and performing clicks and typing.

How do I capture and inspect UI state for macOS automation?

To capture and inspect UI state for macOS automation, use the see command. It targets and reads UI elements, sharing a snapshot cache with other commands to support scripting and deterministic workflows.

Can I script macOS UI testing workflows with JSON output?

Yes, you can script macOS UI testing workflows using the --json flag. Commands support JSON output for scripting, allowing you to automate end-to-end tasks like capture, click, type, and see workflows.

What's the best way to perform automated clicks and typing on macOS?

The best way to perform automated clicks and typing on macOS is using dedicated click and type commands. These commands drive input directly into targeted UI elements for repeatable, scripted interactions.

Does macOS UI automation work for accessibility validation?

Yes, macOS UI automation works for accessibility validation. By inspecting UI elements and capturing UI state, you can validate accessibility features and ensure scripted workflows function correctly across macOS apps.

How do I ensure deterministic results when running macOS UI automation scripts?

To ensure deterministic results when running macOS UI automation scripts, use global flags and configuration options. Running via polter peekaboo also ensures fresh builds for consistent, repeatable execution.