peekaboo

Automate macOS UI capture, inspection, and input control via accessibility workflows.

2|Updated May 23, 2026
One-click install
npx skills add https://github.com/enclawed/enclawed-oss --skill peekaboo-enclawed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/enclawed/enclawed-oss/tree/main/skills/peekaboo
Command: npx skills add https://github.com/enclawed/enclawed-oss --skill peekaboo-enclawed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo removes the friction of manually controlling macOS apps when you need repeatable screen inspection, element targeting, and input automation across different windows and system surfaces.

Core Features & Use Cases

  • Capture and inspect screens, windows, menus, dialogs, and app state with annotated visual maps.
  • Drive reliable interactions such as click, drag, type, scroll, hotkey, and app or window management.
  • Use it for login flows, UI testing, helpdesk automation, desktop demos, or scripted navigation where coordinates alone are not enough.

Quick Start

Use Peekaboo to inspect the active macOS app, identify the correct target, and click it before typing the requested text.

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 like clicking and typing across different windows?

macOS UI automation is achieved by capturing screens, inspecting elements, and driving interactions like click, drag, type, and scroll. This tool targets apps, windows, or coordinates to script reliable desktop workflows.

Do I need special permissions to run macOS screen recording and accessibility automation scripts?

Yes, macOS screen recording and accessibility automation require explicit Screen Recording and Accessibility permissions. You must grant these system privileges to allow snapshot caching, element inspection, and programmatic input control.

Can I inspect macOS menus, dialogs, and dock elements for automated UI testing?

Yes, you can inspect macOS menus, dialogs, and dock elements for UI testing. The tool captures app states and generates annotated visual maps to help identify correct targets before executing scripted interactions.

What is the best way to target specific UI elements instead of using screen coordinates for desktop automation?

The best way to target UI elements for desktop automation is by using accessibility-driven workflows. You can target elements directly by app, window, or snapshot rather than relying solely on static screen coordinates.

How does snapshot caching work for macOS window management and scripted navigation?

Snapshot caching stores captured visual states of macOS windows and menus during automation. This mechanism allows subsequent actions to reference and inspect these cached maps to drive reliable scripted navigation and testing.

Does this tool output structured data for integrating macOS UI inspection into larger workflows?

Yes, the tool outputs structured JSON data from its macOS UI inspection and automation tasks. This format allows you to easily integrate captured screen states, element properties, and workflow results into larger automated pipelines.