skills.rest
Kastalien-Research
Kastalien-ResearchOFFICIAL
Explore all skills by this author →
WebsiteGitHub

peekaboo

Automates macOS UI tasks via a scriptable command-line interface.

Updated Mar 23, 2026
Search Tags:#automation#testing#cli#macos#scripting#ui-automation
One-click install
npx skills add https://github.com/Kastalien-Research/kastalien-factory --skill peekaboo-kastalien-research
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Kastalien-Research/kastalien-factory/tree/main/lettabot/.skills/peekaboo
Command: npx skills add https://github.com/Kastalien-Research/kastalien-factory --skill peekaboo-kastalien-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manual macOS UI automation is tedious and error-prone. Peekaboo provides a CLI to automate UI tasks such as capturing screens, inspecting UI elements, driving input, and managing apps/windows/menus, enabling repeatable and scriptable workflows.

Core Features & Use Cases

  • Core capabilities include screen capture, element targeting, input automation, and comprehensive app/window control for macOS UI workflows.
  • Use cases span automated UI testing, scripted UI interactions, state verification, and rapid prototyping of UI automation tasks.

Quick Start

Install Peekaboo, then run a few commands like see, click, and type to automate a simple macOS 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?▼

Automate macOS UI tasks using a CLI that captures screens, inspects UI elements, and drives input across apps and windows. You can script repeatable workflows by running commands like see, click, and type to interact with the interface.

Can I capture screens and inspect UI elements during automated testing on macOS?▼

Yes, capturing screens and inspecting UI elements during automated testing on macOS is fully supported. The tool provides image capture and element targeting features, outputting results in JSON format for easy state verification.

What do I need to script UI automation for macOS applications?▼

To script UI automation for macOS applications, you need the Peekaboo CLI installed on your system. It provides commands for app and window management, input automation, and screen capture without requiring additional dependencies.

What is the best way to drive input and manage windows in macOS automation scripts?▼

The best way to drive input and manage windows in macOS automation scripts is using a dedicated CLI. It coordinates cross-component actions, manages apps and menus, and uses a snapshot cache to accurately target UI elements.

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

Yes, macOS UI automation supports JSON output for scripting integration. By using the --json and --verbose flags, the CLI returns structured data from screen captures and element inspections, enabling seamless integration into automated testing pipelines.

Why does my macOS UI automation script fail to find the correct UI elements?▼

macOS UI automation scripts may fail to find UI elements if the snapshot cache is outdated or the target window is not in focus. Using the --verbose flag helps inspect the element targeting logic and cross-component coordination to resolve the issue.

Related Skills

Explore More Software Engineering Skills→
kelinfoxykelinfoxy
1

peekaboo

Automate macOS UI interactions via the Peekaboo CLI.

Community
Advanced
abhiunixabhiunix
1

peekaboo

Automate macOS UI tasks via CLI with JSON output.

Community
Intermediate
Dolonia333Dolonia333

peekaboo

Automate macOS UI interactions with the Peekaboo CLI.

Community
Advanced
autonomy-cloudautonomy-cloud
2

macos-automation

Automate native macOS app interactions using AppleScript via osascript.

Official
Intermediate