peekaboo

Automate macOS UI interactions and input driving via the Peekaboo CLI.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/kulharir7/karya --skill peekaboo-kulharir7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/kulharir7/karya/tree/main/workspace/plugins/peekaboo
Command: npx skills add https://github.com/kulharir7/karya --skill peekaboo-kulharir7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate macOS UI interactions, captures, and input driving from the command line to replace repetitive manual tasks across apps and windows.

Core Features & Use Cases

Peekaboo is a full macOS UI automation CLI: capture/inspect screens, target UI elements, drive input, and manage apps/windows/menus. Commands share a snapshot cache and support --json/-j for scripting. Tip: run via polter peekaboo to ensure fresh builds.

Quick Start

Run peekaboo see to identify a target, then perform a click and type sequence to automate a simple 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 interactions from the command line?

You can automate macOS UI interactions from the command line using the Peekaboo CLI to capture screens, target UI elements, and drive input. This replaces repetitive manual tasks across applications and windows.

What permissions do I need to run macOS UI automation scripts?

To run macOS UI automation scripts, you need macOS with Screen Recording and Accessibility permissions enabled, plus the Peekaboo binary installed in your PATH to execute commands properly.

Can I use macOS UI automation for GUI testing and quick prototyping?

macOS UI automation can be used for GUI testing and quick-prototyping tasks across apps and windows. You can capture screens, inspect UI elements, drive input, and manage applications through scriptable commands.

How do I identify and target UI elements for macOS workflow automation?

To identify and target UI elements for macOS workflow automation, run the peekaboo see command to inspect the screen. You can then perform click and type sequences to automate specific UI interactions.

Does macOS UI automation support JSON output for scripting?

macOS UI automation supports JSON output for scripting by using the --json or -j flag on commands. Commands also share a snapshot cache to facilitate integrated workflow automation tasks.

What's the best way to ensure fresh builds when automating macOS UI tasks?

To ensure fresh builds when automating macOS UI tasks, run commands via polter peekaboo. This approach guarantees you are using the latest build for your UI automation workflows.