skills.rest
JoeyJoziah
JoeyJoziahCOMMUNITY
Explore all skills by this author →
GitHub

peekaboo

Automate macOS UI capture, inspection, and interaction workflows via the Peekaboo CLI.

Updated Aug 13, 2025
Search Tags:#accessibility#cli#macos#ui automation#window management#screen capture#desktop testing
One-click install
npx skills add https://github.com/JoeyJoziah/investment-analysis-platform --skill peekaboo-joeyjoziah
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/JoeyJoziah/investment-analysis-platform/tree/main/.claude/skills/peekaboo
Command: npx skills add https://github.com/JoeyJoziah/investment-analysis-platform --skill peekaboo-joeyjoziah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo removes the friction of manually inspecting and operating macOS apps by giving you a single CLI for screen capture, element discovery, input automation, and window management.

Core Features & Use Cases

  • UI Inspection: Capture screens or app windows, annotate targets, and identify clickable elements before acting.
  • Interactive Automation: Click, type, drag, scroll, press keys, and run scripted UI flows against apps, dialogs, and menus.
  • System Control: Manage apps, windows, Dock items, menu bar items, Spaces, and clipboard content from the terminal.
  • Use Case: Use it to automate login flows, verify UI states, capture screenshots for debugging, or drive repetitive desktop tasks on macOS.

Quick Start

Run Peekaboo permissions, inspect the target app with a visual snapshot, and then click or type into the annotated UI element you want to control.

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?▼

Inspect macOS app interfaces by capturing screenshots or app windows, annotating interactive targets, and identifying clickable elements visually before automating any actions, providing a clear map of the UI structure for testing.

What macOS permissions are required for screen capture and UI automation?▼

Screen capture and UI automation on macOS require both Screen Recording and Accessibility permissions. These system-level privileges allow the automation CLI to target elements, manage snapshots, and execute scripted input sequences against desktop apps.

Can I script repetitive desktop tasks and login flows on macOS?▼

Script repetitive desktop tasks and login flows on macOS by executing JSON scripts that drive click, type, drag, and scroll actions. This allows you to automate operational control across apps, dialogs, and menus reliably.

What is the best way to manage windows and menu bar items via terminal automation?▼

Manage windows and menu bar items via terminal automation by using a CLI to handle system control tasks. This includes managing apps, Dock items, Spaces, and clipboard content directly from the command line without manual interaction.

Why is my macOS UI automation not working despite having the CLI installed?▼

macOS UI automation fails if Screen Recording and Accessibility permissions are not fully granted. The CLI requires these system permissions to target elements, manage snapshots, and execute scripted input sequences reliably across desktop apps.

Related Skills

Explore More Software Engineering Skills→
geezerrrrgeezerrrr
117

peekaboo

Automate macOS UI tasks by commanding Peekaboo to inspect and interact with elements.

Community
Advanced
SantiagoisperSantiagoisper

ce-test-xcode

Automates building, testing, and debugging iOS apps on simulators via XcodeBuildMCP.

Community
Intermediate
Claude-Code-Community-IrelandClaude-Code-Community-Ireland
10

bats-testing-patterns

Write unit tests for shell scripts using the Bash Automated Testing System.

Official
Intermediate
dalehurleydalehurley
2

desktop-control

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

Community
Intermediate