peekaboo

Automate macOS UI tasks by capturing screens, targeting elements, and driving input via CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS UI automation often requires manual clicks and repetitive testing across apps. Peekaboo provides a CLI-based solution to capture screens, identify UI elements, and drive input in a deterministic way, enabling repeatable automation and quick UI checks.

Core Features & Use Cases

  • Full CLI for macOS UI automation: capture, inspect, interact, and manage apps/windows/menus.
  • Reusable automation flows: see targets, click, type, and script sequences with a shared snapshot cache.
  • Use cases include UI testing, onboarding flows, accessibility checks, and routine UI tasks in macOS apps such as Safari, Finder, and System Settings.

Quick Start

Install Peekaboo, grant Screen Recording and Accessibility permissions, then run a simple see and click sequence to automate a UI task.

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 from the command line by capturing screens, targeting UI elements, and driving input via a CLI. This enables repeatable automation flows for testing and routine operations across apps like Safari and Finder.

What macOS permissions do I need for UI scripting and screen capture?

macOS UI scripting requires Screen Recording and Accessibility permissions to capture screens and drive input. These system permissions let the CLI inspect interface elements and interact with apps like Safari and Finder.

Can I automate clicks and typing in Safari and Finder using a CLI?

Automating clicks and typing in Safari and Finder is supported by seeing UI targets, executing click and type sequences, and managing windows via a CLI. This enables repeatable interaction flows for native macOS apps.

How do I run UI testing and accessibility checks on macOS apps?

UI testing and accessibility checks on macOS apps are run by capturing screens, inspecting UI elements, and scripting interaction sequences via a CLI. This enables repeatable verification of onboarding flows and routine interface tasks.

Does macOS UI automation work without installing additional binaries?

macOS UI automation via this approach requires an installed binary available in PATH, typically installed via Homebrew. The macOS environment must have the tool present to execute CLI commands for capturing screens and driving input.