skills.rest
Cyandex
CyandexCOMMUNITY
Explore all skills by this author →
GitHub

peekaboo

Capture and automate macOS UI interactions via the Peekaboo CLI.

1|Updated Mar 3, 2026
Search Tags:#accessibility#cli#macos#ui automation#screenshot#peekaboo#desktop control
One-click install
npx skills add https://github.com/Cyandex/ErnOS --skill peekaboo-cyandex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Cyandex/ErnOS/tree/main/skills/peekaboo
Command: npx skills add https://github.com/Cyandex/ErnOS --skill peekaboo-cyandex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Automating macOS graphical interfaces normally requires manual clicking, typing, and screenshot inspection. This Skill exposes the Peekaboo CLI so an agent can capture screens, identify UI elements, and drive mouse, keyboard, apps, windows, menus, and dialogs programmatically. ## Core Features & Use Cases - Screen Capture & Vision: Take screenshots of screens, windows, or menu bar regions, generate annotated UI maps with see, and optionally analyze captures with a prompt. - UI Interaction: Click, type, drag, swipe, scroll, press hotkeys, and paste into targeted apps, windows, or element IDs with smart focus handling. - System Control: Launch, quit, hide, and switch apps; manage windows, Spaces, Dock items, menus, menu bar extras, dialogs, and the clipboard. - Use Case: Automate a Safari login flow by running peekaboo see --annotate to map the page, then click the username field, type credentials, and submit — all without touching the mouse. ## Quick Start Ask the agent to use Peekaboo to take an annotated screenshot of the frontmost app and click a specific button by its element ID.

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 get element IDs, then `peekaboo click --on <id>` and `peekaboo type "text"` targeting the app. It supports targeting by app name, window title, window ID, element ID, or coordinates.

How to capture a screenshot of a specific window on macOS?▼

Run `peekaboo image --app Safari --window-title "Dashboard" --path /tmp/shot.png`. You can also capture full screens with `--mode screen`, use `--retina` for high resolution, and add `--analyze "prompt"` for AI analysis of the capture.

What permissions does Peekaboo need on macOS?▼

Peekaboo requires Screen Recording and Accessibility permissions granted in macOS System Settings. Run `peekaboo permissions` to check the current status of both before attempting captures or UI interaction.

Does Peekaboo work on Windows or Linux?▼

No, Peekaboo is macOS-only (Darwin). It relies on macOS accessibility APIs, the Dock, Spaces, and menu bar, so it cannot run on other operating systems.

Why does peekaboo click fail to find a UI element?▼

Element IDs come from a snapshot, so run `peekaboo see --annotate` first and use the IDs from the latest snapshot. If the UI changed, retake the snapshot; you can also fall back to `--coords x,y` targeting.

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
mrnovamax-ctrlmrnovamax-ctrl

webapp-testing

Automate end-to-end testing of local web applications with Playwright.

Community
Intermediate
noname300989noname300989

cron

Manage gateway job scheduling with cron syntax for recurring and one-shot tasks.

Community
Intermediate
dalehurleydalehurley
2

desktop-control

Automate mouse, keyboard, and screen reading on macOS via pyautogui and AppleScript.

Community
Intermediate