peekaboo

Automate macOS UI tasks by capturing, inspecting, and driving UI components.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS UI automation and screen interaction can be tedious and error-prone when performed manually. Peekaboo provides a CLI to capture, inspect, and automate UI elements, windows, and dialogs to streamline repetitive tasks.

Core Features & Use Cases

  • Automate UI actions across apps: launch, quit, click, type, and navigate through dialogues and menus.
  • Capture and analyze UI state: take screenshots, inspect elements, and verify UI flows with optional annotations.
  • Scripted automation: run sequences of commands to reproduce user workflows or test scenarios, with shared snapshot caches for consistency.
  • Use Case: quickly automate a login flow in a macOS app by interacting with the app, filling fields, and submitting forms.

Quick Start

Install Peekaboo and run a simple UI automation task with a single command to validate setup.

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 like clicking and typing in desktop apps?

You can automate macOS UI tasks by capturing and inspecting screen elements to drive clicks, typing, and navigation. This streamlines repetitive workflows like app login flows by interacting directly with dialogues and menus.

Can I capture and inspect UI elements on macOS to verify application flows?

Yes, capturing and inspecting UI elements on macOS lets you take screenshots and analyze UI state to verify application flows. Optional annotations help inspect and validate UI components during testing.

What is the best way to script repetitive UI automation sequences on macOS?

Scripting macOS UI automation sequences reproduces user workflows by running command chains. Shared snapshot caches maintain consistency across scripted commands, ensuring reliable execution of test scenarios.

Does macOS UI automation work for accessibility workflows and app testing?

macOS UI automation applies to accessibility workflows and app testing by driving UI components, windows, and dialogs. It launches, quits, and navigates apps to automate interactions across different interfaces.

How do I get started with macOS UI automation using a CLI?

To start macOS UI automation, install the CLI tool and run a simple UI automation task with a single command. This validates your setup and confirms the environment can capture and drive UI elements correctly.

Are there limitations when driving macOS UI components through automation scripts?

Driving macOS UI components through automation scripts requires relying on a modular structure with optional scripts and references. Complex or non-standard dialog interfaces may limit consistent UI element inspection and interaction.