peekaboo

Automate macOS UI interactions via CLI to inspect, target, and drive elements.

7|12|Updated Mar 10, 2026

Search Tags:#automation #accessibility #cli #macos #ui-testing #screen-capture #ui-automation

Ready to run

npx skills add https://github.com/borealBytes/my-farm-advisor --skill peekaboo-borealbytes

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/borealBytes/my-farm-advisor/tree/main/skills/peekaboo
Command: npx skills add https://github.com/borealBytes/my-farm-advisor --skill peekaboo-borealbytes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo solves the challenge of automating macOS UI interactions by providing a CLI to inspect, target, and drive UI elements, enabling repeatable tests and workflows.

Core Features & Use Cases

Capture and inspect screens, elements, and states
Target UI components and drive input (click, type, hotkeys)
Launch, manage, and automate apps/windows/menus with a snapshot-enabled workflow
Produce JSON outputs for scripting and integration

Quick Start

Install Peekaboo and verify a simple UI task to confirm functionality.

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

You can automate macOS UI interactions by using a CLI to inspect, target, and drive UI elements. This approach enables repeatable tests and automated workflows across desktop apps and windows without manual input.

What is the best way to capture screen elements and states for UI testing on macOS?▼

Capturing screen elements and states for UI testing is best handled by a CLI tool that snapshots UI components. This allows you to inspect current states and produce JSON outputs for scripting and integration.

Do I need Homebrew to install a CLI tool for macOS desktop automation?▼

Yes, you need Homebrew to install the required binary for macOS desktop automation. The automation process requires macOS (darwin) and its specific CLI binary to properly inspect and drive UI elements.

Can I drive input like clicks and hotkeys across different apps using a CLI?▼

Yes, you can drive input like clicks and hotkeys across different apps using a CLI. It targets specific UI components to launch, manage, and automate apps, windows, and menus with a snapshot-enabled workflow.

Does macOS UI automation support JSON outputs for scripting integration?▼

macOS UI automation supports JSON outputs for scripting and integration. By capturing and inspecting screens and elements, the CLI generates structured data that can be directly consumed by downstream scripts.