skills.rest
DharambirAgrawal
DharambirAgrawalCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

peekaboo

Automate macOS UI interactions via the Peekaboo CLI.

Updated Jan 29, 2026
Search Tags:#automation#testing#ui#cli#macos#scripting#windows
One-click install
npx skills add https://github.com/DharambirAgrawal/Personal-Assistant --skill peekaboo-dharambiragrawal
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
bitan-delbitan-del
4

peekaboo

Automate macOS UI interactions to inspect elements, drive input, and manage applications.

Community
Advanced
jie023jie023
36

test-function

Automate web application functional testing with Playwright and MCP tooling.

Community
Advanced
dandacompanydandacompany
22

bk-start

Start, resume, and manage multi-step AI workflows with session control.

Community
Intermediate
autonomy-cloudautonomy-cloud
2

macos-automation

Automate native macOS app interactions using AppleScript via osascript.

Official
Intermediate