peekaboo

Capture screenshots, identify UI elements, and drive input events on macOS.

55|6|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/NJX-njx/opensoul --skill peekaboo-njx-njx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/NJX-njx/opensoul/tree/main/skills/peekaboo
Command: npx skills add https://github.com/NJX-njx/opensoul --skill peekaboo-njx-njx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables users to capture, inspect, and automate macOS user interface elements, simplifying UI testing and interaction scripting.

Core Features & Use Cases

  • UI Automation: Capture screens, identify UI elements, and drive input events for automating repetitive tasks.
  • System Control: Launch, quit, and manage applications and windows programmatically.
  • Use Case: Automate logging into a website by capturing login fields, filling credentials, and submitting forms seamlessly.

Quick Start

Run peekaboo capture to take a screenshot of your current screen, then use peekaboo click to interact with UI components or scripts to automate complex workflows.

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 like clicking and capturing screenshots?

macOS UI automation lets you capture screens, identify UI elements, and drive input events programmatically. You can run command-line tools to take screenshots and interact with UI components to automate repetitive desktop tasks.

How does UI element identification work for macOS desktop applications?

UI element identification works by inspecting the macOS desktop environment to capture and locate interactive components. This mechanism allows you to target specific elements like login fields or buttons to automate input actions and testing workflows.

Can I use command-line scripting to launch and manage macOS applications?

Yes, you can use command-line scripting to programmatically launch, quit, and manage applications and windows on macOS. This system control capability allows you to integrate GUI management directly into your automated workflows.

What is the best way to script automated website logins on a macOS desktop?

The best way to script automated website logins on macOS is using CLI automation. You capture the login fields, fill in credentials, and submit forms seamlessly by driving input events across applications programmatically.

Do I need peekaboo installed to control macOS user interface elements via scripts?

Yes, you need the peekaboo command-line tool installed as a dependency. It provides the core macOS UI automation capabilities required to inspect, control, and script desktop environments from your terminal.

Why use a command-line tool for macOS UI testing instead of other automation methods?

Using a command-line tool for macOS UI testing offers flexible, scriptable control of GUIs. It simplifies inspecting and controlling desktop environments, making it ideal for developers integrating automation and testing into existing terminal workflows.