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.