peekaboo

Automate macOS UI testing and tasks via the Peekaboo CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS UI automation can be tedious and error-prone when performed manually across apps, windows, and menus. Peekaboo provides a command-line interface to capture, inspect, and drive UI interactions, turning repetitive tasks into repeatable scripts.

Core Features & Use Cases

  • Capture and inspect screens to identify targets and verify UI state
  • Target UI elements and drive input to launch, switch, or control apps and windows
  • Automate workflows by scripting common actions with predictable behavior and a shared snapshot cache

Quick Start

Install Peekaboo and run a sample automation sequence from the CLI to observe the UI automation workflow.

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 using a command-line interface to capture screens, inspect UI elements, and drive input. This allows you to script repetitive interactions across apps and windows with predictable behavior.

Can I inspect UI elements and capture screens for macOS automation?

Yes, you can inspect UI elements and capture screens to identify targets and verify UI state. This functionality helps locate specific elements and confirm that application interfaces respond correctly during automated workflows.

What is the best way to script repetitive macOS app interactions without external dependencies?

Scripting repetitive macOS app interactions is best handled through a local-first CLI that drives input and manages apps without external dependencies. This approach turns error-prone manual tasks into repeatable command-based workflows.

Does macOS UI automation work for managing apps and windows via CLI?

Yes, macOS UI automation via CLI supports managing apps and windows. You can target UI elements to launch, switch, or control applications, enabling automated workflows that handle window management directly from scripts.

How do I verify UI state during command-based macOS automation?

You verify UI state during command-based macOS automation by capturing and inspecting screens. By taking snapshots of the current interface, you can identify targets and ensure the application meets expected conditions before proceeding.