skills.rest
tiancaiamao
tiancaiamaoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

peekaboo

Operates a CLI to capture, inspect, and control macOS UI elements.

5|Updated Feb 8, 2026
Search Tags:#accessibility#cli#macos#ui automation#window management#screen capture#screenshot analysis
One-click install
npx skills add https://github.com/tiancaiamao/ai --skill peekaboo-tiancaiamao
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/tiancaiamao/ai/tree/main/skills/peekaboo
Command: npx skills add https://github.com/tiancaiamao/ai --skill peekaboo-tiancaiamao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo removes the friction of manually inspecting and controlling macOS apps by giving you a CLI for reliable UI capture, targeting, and interaction.

Core Features & Use Cases

  • Screen Inspection: Capture screenshots, annotate UI maps, and analyze what is visible on screen.
  • Direct UI Automation: Click, type, drag, scroll, press keys, and run scripted interactions against apps, windows, menus, and system UI.
  • Window and App Control: Launch, quit, focus, move, resize, and switch between applications and Spaces.
  • Use Case: Use it to inspect a login screen, identify a target element, click it, enter credentials, and continue through a desktop workflow without manual guessing.

Quick Start

Ask the assistant to use Peekaboo to capture the current macOS screen, identify the target UI element, and click it.

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

Automate macOS UI workflows by using a CLI to capture screenshots, inspect screen elements, and orchestrate clicks and keystrokes. This approach removes manual guessing by applying deterministic, snapshot-based targeting for scripted app interactions.

Do I need special permissions for macOS screen capture and UI automation?▼

Yes, macOS screen capture and UI automation require granting Screen Recording and Accessibility permissions to your execution environment. These system privileges allow the CLI to inspect visible screen elements and orchestrate programmatic control inputs.

Can I use this to identify and interact with specific UI elements on macOS?▼

Yes, you can identify and interact with specific UI elements on macOS by capturing a screen snapshot, analyzing the visible interface to locate the target, and executing precise clicks or text input. This bridges visual inspection with direct application control.

What is the best way to script window management and app control on macOS?▼

The best way to script window management and app control on macOS is using a CLI that supports launching, focusing, moving, and resizing applications. This provides deterministic execution and JSON output for automating complex desktop workflows.

How does snapshot-based targeting work for macOS UI testing?▼

Snapshot-based targeting works by capturing the current macOS screen state and analyzing the visual hierarchy to pinpoint UI elements. This allows automated scripts to reliably click, type, or navigate menus based on deterministic visual inspection rather than fragile coordinates.

Related Skills

Explore More Software Engineering Skills→
kcns008kcns008
5

peekaboo

Automate macOS UI inspection and interaction via the Peekaboo CLI.

Community
Advanced
JoeyJoziahJoeyJoziah

peekaboo

Automate macOS UI capture, inspection, and interaction workflows via the Peekaboo CLI.

Community
Advanced
ShravanSunderShravanSunder

peekaboo

Automate visual UI testing for macOS applications using the Peekaboo CLI.

Community
Intermediate
enclawedenclawed
2

peekaboo

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

Community
Advanced