skills.rest
JEROME-PRAKASH-L
JEROME-PRAKASH-LCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

peekaboo

Capture and automate macOS UI interactions through the Peekaboo CLI.

1|Updated Jun 9, 2026
Search Tags:#accessibility#cli#macos#ui automation#screenshot#screen capture#peekaboo
One-click install
npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill peekaboo-jerome-prakash-l
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/JEROME-PRAKASH-L/openclaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill peekaboo-jerome-prakash-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Automating macOS desktop tasks normally requires manual clicking, typing, and window management. This Skill lets an AI assistant capture screens, inspect UI elements, and drive mouse, keyboard, app, window, and menu actions through the Peekaboo CLI. ## Core Features & Use Cases - Screen Capture and Inspection: Take screenshots, generate annotated UI maps with see, and optionally analyze captures with AI prompts. - Input Automation: Click, type, drag, scroll, swipe, and trigger hotkeys targeting elements by ID, query, or coordinates. - System Control: Launch and quit apps, manage windows and Spaces, interact with menus, the Dock, menu bar, dialogs, and the clipboard. - Use Case: Automate a login flow by running peekaboo see --annotate to identify fields, then peekaboo click and peekaboo type to fill in credentials and submit the form. ## Quick Start Ask the assistant to take an annotated screenshot of the frontmost app and click a specific button using Peekaboo.

Frequently Asked Questions about peekaboo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate clicking and typing in macOS apps from the command line?▼

Use the Peekaboo CLI: run `peekaboo see --annotate` to capture an annotated UI map with element IDs, then `peekaboo click --on <id>` and `peekaboo type "text"` to interact with those elements. Target specific apps with `--app` or windows with `--window-id`.

How do I take a screenshot of a specific window on macOS programmatically?▼

Run `peekaboo image --app Safari --window-title "Dashboard" --path /tmp/shot.png` to capture a specific window. You can also use `--mode screen` for full displays, `--retina` for high resolution, and `--analyze` to get an AI description of the capture.

What permissions does Peekaboo need on macOS?▼

Peekaboo requires Screen Recording and Accessibility permissions. Check their status with `peekaboo permissions` or `peekaboo permissions status --json`. On macOS 15+, a separate prompt for bypassing the private window picker may also appear.

Why does Peekaboo screen capture fail in a subprocess?▼

Subprocess captures fail when the calling process lacks its own Screen Recording grant. Diagnose with `peekaboo bridge status --json`, then `peekaboo permissions status --json`, and use the default Bridge path instead of passing `--no-remote`.

Can Peekaboo run on Linux or Windows?▼

No, Peekaboo is macOS-only. It relies on macOS-specific APIs for screen capture, accessibility, and window management, and is distributed as a Homebrew formula for macOS systems.

Related Skills

Explore More Software Engineering Skills→
trpc-grouptrpc-group
1.8k

peekaboo

Capture and automate macOS UI interactions using the Peekaboo CLI.

Official
Intermediate
GNHuaGNHua
24

android-layer2-test

Execute Layer 2 adb visual verification flows and capture screenshots for Android devices.

Community
Advanced
wenermewenerme
7

peekaboo

Automate macOS UI interactions with an observe-act-verify loop and JSON output.

Community
Advanced
dallaydallay
9

Desktop Expert

Guide Kotlin Multiplatform Compose desktop development with window management and OS integration.

Official
Advanced