skills.rest
victor-brechbill
victor-brechbillOFFICIAL
Explore all skills by this author →
GitHub

peekaboo

Automate macOS UI interactions and system tasks via the Peekaboo CLI.

1|Updated Feb 24, 2026
Search Tags:#developer tools#cli#macos#scripting#ui automation#gui
One-click install
npx skills add https://github.com/victor-brechbill/claw-kernel --skill peekaboo-victor-brechbill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/victor-brechbill/claw-kernel/tree/main/skills/peekaboo
Command: npx skills add https://github.com/victor-brechbill/claw-kernel --skill peekaboo-victor-brechbill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates complex interactions with the macOS graphical user interface, enabling scripting of applications and system elements that are otherwise difficult to control programmatically.

Core Features & Use Cases

  • UI Element Interaction: Click, type, drag, and scroll through UI elements using robust targeting.
  • Application & Window Management: Launch, quit, focus, and manipulate application windows.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
  • Use Case: Automate the process of logging into a desktop application, filling out a form within it, and then capturing a screenshot of the result.

Quick Start

Run peekaboo permissions to check necessary macOS permissions for UI automation.

Frequently Asked Questions about peekaboo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate macOS GUI interactions from the command line?▼

Automate macOS GUI interactions from the command line by targeting UI elements for clicking, typing, and dragging. This approach enables scripting complex desktop application workflows and system tasks that lack direct API access.

Do I need special permissions to automate macOS UI elements?▼

Special permissions are required to automate macOS UI elements. You must grant Screen Recording and Accessibility permissions to your terminal or automation tool, which you can verify and configure by running the permissions check command.

Can I capture screenshots and record screen activity using CLI scripting?▼

You can capture screenshots and record screen activity using CLI scripting. The automation supports taking still captures of specific windows or the full screen and analyzing the visual content directly within your scripts.

What is the best way to script application window management on macOS?▼

Scripting application window management on macOS is best handled through CLI commands that launch, quit, and focus applications. This method allows robust programmatic control over manipulating application windows within automated workflows.

Why is my macOS UI automation script not clicking the correct elements?▼

macOS UI automation scripts fail to click correct elements when targeting is inaccurate or required Accessibility permissions are missing. Ensure your script uses robust element targeting parameters and has the necessary system privileges enabled.

Does Peekaboo support automating login flows and form submissions on macOS?▼

Peekaboo supports automating login flows and form submissions on macOS. It can simulate input to fill out fields within desktop applications and capture a screenshot of the resulting state for verification.

Related Skills

Explore More Software Engineering Skills→
rafaelcallejarafaelcalleja
2

gemini-cli

Interact with Gemini AI models through a command-line interface.

Community
Intermediate
traylinxtraylinx
2

vision-expert

Analyze images and screenshots to extract layout patterns, UI components, and diagrams.

Official
Advanced
badbsallyybadbsallyy

peekaboo

Automate macOS UI interactions and capture screen content via the Peekaboo CLI.

Community
Advanced
L-LesterYuL-LesterYu
51

Desktop Control

Automate mouse, keyboard, and window management with pyautogui and pygetwindow.

Community
Advanced