peekaboo

Automate macOS UI tasks via CLI with JSON output.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates macOS user interface tasks using a CLI to capture, inspect, and drive UI elements.

Core Features & Use Cases

  • Capture and inspect screens
  • Target UI elements, drive input, and manage apps/windows/menus
  • Snapshot cache and JSON output for scripting

Use cases include automating repetitive UI workflows across macOS apps, UI testing, and routine maintenance tasks.

Quick Start

Run peekaboo to begin automating a macOS UI workflow on your workstation.

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 running the peekaboo CLI to capture, inspect, and drive user interface elements directly from your terminal. It supports capturing screens, targeting UI elements, and managing apps or windows for automation workflows.

What is macOS UI automation used for in local testing workflows?

macOS UI automation is used for visual UI testing, automating repetitive workflows across applications, and routine local maintenance tasks. It allows scripts to capture screens, drive input, and manage menus without manual interaction.

How do I get JSON output from a macOS UI automation script?

You can get JSON output by using the --json-output support provided by the peekaboo CLI. This allows your scripting environment to programmatically parse inspection results, UI element states, and snapshot cache data.

Can I use a CLI tool to drive input and manage macOS app windows?

Yes, you can use the peekaboo CLI to drive input, target specific UI elements, and manage apps, windows, and menus on your macOS workstation. This enables comprehensive user interface automation workflows.

Does macOS UI automation support deterministic runs for continuous integration?

Yes, the peekaboo CLI provides specific guidance for deterministic runs to ensure your macOS UI automation workflows execute consistently. This is combined with snapshot caching to support reliable visual UI testing.