peekaboo

Capture, inspect, and drive macOS UI elements via CLI.

5|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/p-sree-sai-pavan/P.A.R.K.E.R --skill peekaboo-p-sree-sai-pavan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/p-sree-sai-pavan/P.A.R.K.E.R/tree/main/gateway/skills/peekaboo
Command: npx skills add https://github.com/p-sree-sai-pavan/P.A.R.K.E.R --skill peekaboo-p-sree-sai-pavan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS UI automation often requires ad-hoc scripts and manual steps. Peekaboo provides a unified CLI to capture, inspect, and control UI elements, enabling consistent automation and testing workflows.

Core Features & Use Cases

  • Capture and inspect UI elements, drive input, manage apps/windows/menus, and share visual state across commands.
  • Script-friendly interactions with a wide set of commands for UI navigation, input, and system dialogs.
  • Vision and feedback: annotated maps and live feedback to verify targets before actions.

Quick Start

Install Peekaboo and run a quick check to see the CLI capture and control UI elements.

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 from the command line?

You can automate macOS UI interactions from the command line by using a CLI tool that captures, inspects, and drives UI elements to execute testing and workflow scripting across apps and windows.

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

Yes, running macOS UI automation scripts requires granting Screen Recording and Accessibility permissions to the runtime, allowing the CLI to capture visual state and control system dialogs.

Can I capture and inspect UI elements during automated macOS testing?

Yes, you can capture and inspect UI elements during automated macOS testing by generating annotated maps and live feedback to visually verify targets before driving input or navigating menus.

How do I script everyday macOS tasks and manage windows without manual steps?

You can script everyday macOS tasks and manage windows by issuing CLI commands that drive input, navigate system dialogs, and control apps to achieve consistent workflow automation without manual execution.

What is the best way to get structured output from macOS UI automation scripts?

The best way to get structured output from macOS UI automation scripts is to use global runtime flags like --json, which formats inspection and capture results for programmatic processing and integration.

Why is my macOS UI automation not working when interacting with system dialogs?

macOS UI automation may fail when interacting with system dialogs if the runtime lacks Screen Recording and Accessibility permissions, preventing the CLI from driving input or capturing UI elements correctly.