skills.rest
joeleung0122
joeleung0122COMMUNITY
Explore all skills by this author →
GitHub

peekaboo

Automate macOS UI tasks with the Peekaboo CLI for screens, elements, and input.

Updated Feb 3, 2026
Search Tags:#automation#cli#macos#peekaboo#screen-capture#ui-automation#element-targeting
One-click install
npx skills add https://github.com/joeleung0122/testing --skill peekaboo-joeleung0122
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/joeleung0122/testing/tree/main/skills/peekaboo
Command: npx skills add https://github.com/joeleung0122/testing --skill peekaboo-joeleung0122

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo automates macOS UI interactions by capturing and inspecting screens, targeting UI elements, driving input, and managing apps, windows, and menus, reducing repetitive manual GUI tasks.

Core Features & Use Cases

  • Capture live screens and inspect UI elements
  • Target elements and drive input (click, type, drag)
  • Manage apps/windows/menus and navigate the macOS UI
  • Share a snapshot cache and output JSON for scripting with --json-output
  • See annotated UI maps and gain automation capabilities across workflows

Quick Start

Launch Peekaboo from the CLI to capture a screen, locate a UI element, and perform an automated action.

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 using the Peekaboo CLI to capture screens, target UI elements, drive input, and manage apps and windows. It supports JSON output for integration into shell scripts.

Can I capture a screen and target specific UI elements for testing on macOS?▼

Yes, screen capture and UI element targeting are supported. The tool inspects screens, locates elements, and performs automated actions like clicking, typing, and dragging across macOS applications.

How do I script automated GUI interactions and get structured output?▼

You can script GUI interactions by using the --json-output flag. This provides structured JSON data from your screen captures and UI automation runs, making it easy to parse results in automated workflows.

Do I need any specific dependencies to run macOS UI automation with Peekaboo?▼

You need a macOS environment and the Peekaboo binary installed. The tool relies on these to drive input, manage applications, and navigate the macOS UI without additional external dependencies.

What is the best way to manage apps and windows during macOS UI automation?▼

The best way to manage apps and windows is using the Peekaboo CLI, which directly controls applications, navigates menus, and handles window states while utilizing a snapshot cache to optimize automation workflows.

Are there limitations when using screen capture for UI automation on macOS?▼

Limitations include being restricted to the macOS platform and requiring the Peekaboo binary. Automation relies on screen capture and element targeting, which may be affected by UI rendering delays or inaccessible elements.

Related Skills

Explore More Software Engineering Skills→
Zentin-LZentin-L
1

peekaboo

Automate macOS UI tasks by capturing screens, targeting elements, and driving input via CLI.

Community
Advanced
InternScienceInternScience
52

gjf-to-xyz

Parse Gaussian gjf input files and convert them to XYZ format.

Official
Intermediate
JacksonZx535JacksonZx535

ship

Automate software release workflows with Git and GitHub PR creation.

Community
Advanced
letta-ailetta-ai
327

peekaboo

Automate macOS UI interactions and testing via the Peekaboo CLI.

Official
Advanced