peekaboo

Automate macOS UI inspection and interaction via a CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo simplifies macOS UI automation by providing a single CLI to inspect screens, identify UI elements, and drive input across apps. It enables repeatable UI tests, accessibility checks, and automation of repetitive UI tasks without manual intervention.

Core Features & Use Cases

  • Inspect and capture UI state (screens, windows, elements) for debugging or test planning.
  • Drive input, click, type, and automate workflows across macOS apps.
  • Use cases: automate repetitive UI tasks, perform UI testing, create reproducible UI demos.

Quick Start

Install and run Peekaboo, then start automating common UI tasks:

  • See: peekaboo see --app Safari --window-title "Login" --annotate --path /tmp/see.png
  • Click: peekaboo click --on B1 --app Safari
  • Type: peekaboo type "[email protected]" --app Safari --return

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 CLI by capturing screens, identifying UI elements, and driving inputs like clicks and typing across apps to execute repetitive workflows without manual intervention.

How do I capture and inspect macOS UI elements for testing?

To inspect macOS UI elements for testing, you can use a CLI command to capture the screen, annotate specific windows or apps, and save the visual state to an image file for debugging and test planning.

Do I need a specific macOS environment to run UI automation testing?

Yes, running UI automation testing requires a macOS environment with the specific Peekaboo binary installed to properly identify targets, capture screens, and drive input across native applications.

What is the best way to drive input and click elements across macOS apps?

The best way to drive input across macOS apps is using a CLI to target specific UI elements by their identifiers, allowing you to click buttons, type text, and manage application windows reproducibly for demos or tests.

Can I automate repetitive UI workflows without manual intervention on macOS?

Yes, you can automate repetitive UI workflows on macOS by chaining CLI commands to inspect the screen state, drive input, and manage windows, creating repeatable automated tests and demos without manual intervention.