peekaboo

Automate macOS GUI interactions and annotate screenshots via the peekaboo CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mac users often need to automate repetitive GUI tasks and capture annotated screenshots for documentation and QA, which is tedious by hand.

Core Features & Use Cases

  • Annotated screenshots with element IDs for clear UI references
  • Click and type in native macOS apps to automate common workflows
  • Window management and keyboard shortcuts to orchestrate multi-app tasks
  • Lightweight CLI integration to script end-to-end scenarios

Quick Start

Install via brew and run a sample automation to capture an annotated screenshot.

Frequently Asked Questions about peekaboo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate macOS GUI interactions for repetitive desktop tasks?▼

Annotated screenshots add element IDs to your UI captures, providing clear references for QA testing and documentation by labeling interactive components directly within the image.

Can I use a CLI to click and type in native macOS apps?▼

Yes, a lightweight CLI integration supports clicking and typing in native macOS apps, enabling you to script common workflows and automate multi-app tasks via keyboard shortcuts and window management.

What is the best way to capture annotated screenshots for UI testing on macOS?▼

Capturing annotated screenshots for UI testing on macOS is best handled by a CLI that assigns element IDs to UI captures, yielding clear visual references for QA validation and documentation.

Does this desktop automation approach support window management and keyboard shortcuts?▼

Yes, this desktop automation approach supports window management and keyboard shortcuts, allowing you to orchestrate multi-app tasks and script end-to-end scenarios via a CLI.

How do I install and run a sample macOS desktop automation script?▼

To install and run a sample macOS desktop automation script, install the CLI via brew, then execute a sample command to capture an annotated screenshot and validate your setup.