peekaboo

Automates macOS UI tasks via Peekaboo CLI with see, click, type, and window commands.

130|16|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/z80dev/lemon --skill peekaboo-z80dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/z80dev/lemon/tree/main/apps/lemon_skills/priv/builtin_skills/peekaboo
Command: npx skills add https://github.com/z80dev/lemon --skill peekaboo-z80dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo provides macOS UI automation via a CLI to capture, inspect, and interact with UI elements, enabling repeatable tasks across apps and windows.

Core Features & Use Cases

  • See: annotate and identify targets
  • Click / Type: automate input and navigation
  • Window/Dock/Menu: manage apps and UI chrome
  • Visual feedback: see annotations and snapshots

Quick Start

Identify a target with see, then automate actions using click and type to complete a 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 by targeting elements, simulating input, and managing apps and windows using the Peekaboo CLI. It provides commands like see, click, type, dock, menu, and window management to enable repeatable UI workflows across macOS applications.

What is the best way to identify and inspect macOS UI elements for automation?

The best way to identify macOS UI elements for automation is using the see command, which annotates and identifies targets visually. You can capture snapshots and inspect UI elements to locate exactly what you need to interact with.

Do I need special permissions to simulate clicks and typing on macOS?

Yes, simulating clicks and typing on macOS requires Accessibility and Screen Recording permissions to function properly. These permissions allow the automation tool to capture visual feedback and interact with UI elements across applications.

Can I manage app windows and menus using a CLI on macOS?

Yes, you can manage app windows and menus on macOS using CLI commands for window, dock, and menu management. These commands allow you to control the UI chrome of applications and automate navigation through menu items.

How does visual feedback work when automating macOS UI tasks?

Visual feedback in macOS UI automation works by annotating identified targets and capturing snapshots of the screen. The see command highlights UI elements, allowing you to visually verify targets before automating actions like click and type.