peekaboo

Inspects and drives macOS UI elements via scriptable, CLI-based commands.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/Sugamdeol/moltbot-with-pollinations.ai --skill peekaboo-sugamdeol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Sugamdeol/moltbot-with-pollinations.ai/tree/main/skills/peekaboo
Command: npx skills add https://github.com/Sugamdeol/moltbot-with-pollinations.ai --skill peekaboo-sugamdeol

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo addresses the complexity of automating macOS UI testing and interactions by providing a CLI tool to inspect UI elements, drive input, and manage apps/windows.

Core Features & Use Cases

  • Inspect and target UI elements with clear selectors
  • Automate clicks, keystrokes, window management, and dialogs
  • Script reusable workflows for UI validation and accessibility testing
  • Debug with snapshots, logs, and a consistent UI state model

Quick Start

Use Peekaboo to inspect a running macOS app and automate UI actions.

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 by using a CLI tool to inspect UI elements, target them with selectors, and drive inputs like clicks and keystrokes. This allows scripting reusable workflows for app and window management.

What is UI automation for macOS applications and how does it work?

macOS UI automation works by inspecting running apps to identify UI elements, then driving actions like clicks, keystrokes, and dialog management. It relies on a deterministic CLI workflow and accessibility selectors to interact with windows and menus.

Can I script reusable workflows for macOS accessibility testing?

Yes, you can script reusable workflows for macOS accessibility testing by targeting UI elements with clear selectors. The CLI approach allows you to automate UI validation, manage dialogs, and debug using snapshots and logs.

How do I inspect and target UI elements in a running macOS app?

To inspect and target UI elements in a running macOS app, you use a CLI tool that provides clear selectors for UI components. This enables you to automate interactions, drive input, and manage window states deterministically.

Does macOS UI automation require any specific dependencies or components?

No specific dependencies or components are required to start with macOS UI automation. The CLI tool operates independently using a frontmatter-driven entry point to enforce a deterministic workflow for inspecting and driving UI elements.

What is the best way to debug macOS UI automation scripts when they are not working?

The best way to debug macOS UI automation scripts is by using snapshots, logs, and a consistent UI state model provided by the CLI. This helps identify issues with selectors, clicks, or keystrokes during UI validation and testing.