peekaboo

Automate macOS UI interactions via the Peekaboo CLI.

Updated Jan 29, 2026

Search Tags:#automation #testing #ui #cli #macos #scripting #windows

Ready to run

npx skills add https://github.com/DharambirAgrawal/Personal-Assistant --skill peekaboo-dharambiragrawal

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/DharambirAgrawal/Personal-Assistant/tree/main/skills/peekaboo
Command: npx skills add https://github.com/DharambirAgrawal/Personal-Assistant --skill peekaboo-dharambiragrawal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo streamlines macOS UI automation by enabling scripted control of apps, windows, and UI elements from the command line, reducing manual testing time and errors.

Core Features & Use Cases

CLI-based UI automation for macOS to capture targets, drive input, and manage windows
Automate repetitive UI tasks and tests across apps like Safari, Notes, and Finder
Use Case: Create repeatable UI tests that verify app behavior without manual interaction.

Quick Start

Install Peekaboo and run a basic command to see the current UI, such as peekaboo see --app Safari --window-title 'Test'.

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 tasks from the command line?▼

You can automate macOS UI tasks by using a CLI tool to script control of apps, windows, and UI elements, reducing manual testing time. Peekaboo enables this by driving input and capturing targets across native macOS applications.

What do I need to run macOS UI automation scripts?▼

To run macOS UI automation scripts, you need macOS, the Peekaboo binary installed, and appropriate accessibility permissions granted. These ensure reliable interaction with native applications like Safari, Notes, and Finder.

Can I create repeatable UI tests for native macOS apps without manual interaction?▼

Yes, you can create repeatable UI tests for native macOS apps without manual interaction by scripting interactions with elements, windows, and menus. This verifies app behavior consistently from the command line.

How does CLI-based UI automation work for capturing targets and managing windows?▼

CLI-based UI automation works by targeting specific apps and windows using commands like peekaboo see --app Safari --window-title 'Test'. It drives input and manages windows programmatically to execute scripted workflows.

Does macOS UI automation work with Safari, Notes, and Finder?▼

Yes, macOS UI automation works with Safari, Notes, and Finder. It targets UI automation and testing scenarios across these native macOS applications, enabling scripted interaction with their elements and menus.

Why does my macOS UI automation fail to interact with app elements?▼

macOS UI automation fails to interact with app elements when appropriate accessibility permissions are not granted. The tool requires these permissions and the Peekaboo binary on macOS to operate reliably.