peekaboo

Automate macOS UI inspection and interaction via the Peekaboo CLI.

5|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/kcns008/clusterclaw --skill peekaboo-kcns008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/kcns008/clusterclaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/kcns008/clusterclaw --skill peekaboo-kcns008

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo removes the friction of manually inspecting and controlling macOS apps by turning screenshots, element targeting, and input automation into repeatable CLI workflows.

Core Features & Use Cases

  • Screen inspection: Capture screens, annotate UI elements, and identify targets before clicking.
  • Input automation: Click, type, press keys, scroll, drag, and swipe with reliable targeting.
  • System control: Launch, quit, focus, resize, and manage windows, menus, Dock items, and dialogs.
  • Use case: Automate login flows, app setup, dashboard review, and repetitive desktop workflows on macOS.

Quick Start

Use the peekaboo skill to inspect the current screen, identify the correct target, and perform the requested click and typing steps.

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?

Automating macOS UI interactions from the command line involves using a tool like the Peekaboo CLI to capture screens, identify UI elements, and simulate inputs like clicks and typing. It requires granting Accessibility and Screen Recording permissions to operate deterministically.

What is snapshot-based targeting for desktop automation?

Snapshot-based targeting is a desktop automation technique that captures the current screen state to identify and locate UI elements before interacting. This ensures deterministic execution by anchoring input simulation to precise screen coordinates rather than fragile accessibility trees.

Can I manage macOS windows and menus using CLI automation?

Yes, you can manage macOS windows and menus using CLI automation by executing commands to launch, quit, focus, and resize applications. You can also navigate menus, interact with the Dock, and handle dialogs within your scripted desktop workflows.

Do I need special permissions to run macOS screen capture and input automation?

Yes, macOS screen capture and input automation require explicit Accessibility and Screen Recording permissions granted to the executing CLI tool. These security permissions allow the software to inspect interface elements and simulate user inputs like keystrokes and mouse clicks reliably.

Why does my macOS UI automation script fail to find the correct button?

macOS UI automation scripts often fail to find the correct button due to dynamic loading or changing screen states. Using a tool that supports JSON output and snapshot-based targeting helps identify the correct element visually before attempting the click.