peekaboo

Capture and control macOS user interfaces via CLI for automated tasks.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/Yogi-076/Vajrascan.on --skill peekaboo-yogi-076
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Yogi-076/Vajrascan.on/tree/main/moltbot/skills/peekaboo
Command: npx skills add https://github.com/Yogi-076/Vajrascan.on --skill peekaboo-yogi-076

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS UI testing, repetitive interactions, and manual screenshot capture are time-consuming and error-prone; Peekaboo provides a consistent CLI to capture, inspect, and drive macOS user interfaces so tasks can be automated, reproduced, and scripted.

Core Features & Use Cases

  • Automated screen and window capture with annotated UI maps and a snapshot cache for reproducible evidence.
  • Precise element targeting and simulated input (click, type, drag, hotkey) for end-to-end testing, macro automation, and accessibility validation.
  • System controls for app/window/menu/dock management and JSON output for integration with CI, bug reports, or downstream analysis; useful for reproducing login flows, generating annotated bug artifacts, and automating demo recordings.

Quick Start

Run peekaboo permissions to grant Screen Recording and Accessibility, then use peekaboo see --annotate --app Safari to capture an annotated snapshot and peekaboo click --on B3 --app Safari to interact with the page.

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 for end-to-end testing?

To automate macOS UI interactions, use the peekaboo CLI to capture annotated screen snapshots, target elements, and simulate inputs like clicks and typing. This allows you to script and reproduce complex user flows for automated testing without manual intervention.

Can I capture annotated screenshots of macOS apps from the command line?

Yes, you can capture annotated screenshots from the command line by running peekaboo see --annotate --app [AppName]. This generates an annotated UI map and snapshot cache, providing reproducible visual evidence for bug reports or CI integration.

Do I need special permissions to run macOS screen capture and UI automation scripts?

Yes, macOS UI automation requires Accessibility and Screen Recording permissions. You can grant these by running the peekaboo permissions command in your terminal before starting your automated screen capture or simulated input workflows.

What is the best way to click specific UI elements in macOS automation scripts?

The best way to click specific UI elements is using the peekaboo click command with element targeting. Capture an annotated snapshot first to identify element identifiers, then use peekaboo click --on [ElementID] --app [AppName] for precise interaction.

How does JSON output from macOS UI automation integrate with CI pipelines?

Peekaboo provides JSON output for integration with CI pipelines and downstream analysis. This structured data allows automated testing frameworks to parse UI automation results, validate accessibility, and generate programmatic bug artifacts.

Are there limitations when automating macOS dock and menu management via CLI?

Limitations include requiring a macOS environment with an accessible peekaboo CLI binary in PATH. Automation relies on granted Accessibility permissions, meaning scripts may fail if system permissions are revoked or if UI elements are obscured or dynamically rendered.