peekaboo

Capture and control macOS UI elements via CLI commands.

386k|81.1k|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/steipete/clawdis --skill peekaboo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/steipete/clawdis/tree/main/skills/peekaboo
Command: npx skills add https://github.com/steipete/clawdis --skill peekaboo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo.

What problem does it solve?

This Skill automates complex macOS user interface tasks like app control, window management, and automated workflows, saving you from manual computer operations.

Core Features & Use Cases

  • UI Automation: Capture screens, click buttons, type text, and manage applications programmatically.
  • Use Case: When you need to automate software testing, data entry, or any repetitive computer task.

Quick Start

Use peekaboo to capture a screenshot of the current screen and save it for analysis.

Quick Start

List all running applications and capture a screenshot of the active window.

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 on macOS without manual interaction?

macOS UI automation lets you programmatically control clicks, type text, and interact with UI elements through a CLI tool. peekaboo captures screen state, targets specific elements, and simulates input to eliminate repetitive manual tasks like data entry or testing workflows.

Can I automate app control and window management on macOS from the command line?

Yes, CLI-based macOS automation can open applications, manage windows, control menus, and manipulate the Dock programmatically. peekaboo provides commands for these operations plus screen capture and element inspection, enabling end-to-end workflow automation.

What permissions does macOS UI automation require?

macOS UI automation requires Screen Recording and Accessibility permissions to capture screens and control UI elements. peekaboo needs these system permissions granted in System Preferences to function properly for automation tasks.

How do I capture and inspect screen elements for automated testing?

Screen capture and element inspection let you take snapshots, analyze UI structure, and identify target elements programmatically. peekaboo caches snapshots and outputs JSON-structured element data, enabling precise targeting for UI automation and test validation.

Can I use macOS UI automation for software testing workflows?

Yes, macOS UI automation suits functional and regression testing by simulating user interactions, capturing results, and validating UI state. peekaboo supports click, drag, type, scroll, and see commands with JSON output for integrating automated testing into CI/CD pipelines.

Does macOS UI automation work with dragging, scrolling, and keyboard shortcuts?

macOS UI automation supports drag, scroll, type, and input simulation for comprehensive interaction. peekaboo includes commands for these gestures plus menu and window control, covering complex workflows beyond basic clicking.