peekaboo

Automate macOS UI interactions and system tasks via command-line interface.

1|1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/LuisvelMarketer/genome --skill peekaboo-luisvelmarketer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/LuisvelMarketer/genome/tree/main/skills/peekaboo
Command: npx skills add https://github.com/LuisvelMarketer/genome --skill peekaboo-luisvelmarketer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates repetitive tasks on macOS by providing a command-line interface to interact with the UI, capture screens, and manage applications.

Core Features & Use Cases

  • UI Automation: Click, type, drag, and scroll through UI elements programmatically.
  • Screen Capture & Analysis: Capture screenshots, record video, and analyze UI elements.
  • App & Window Management: Launch, quit, focus, and manipulate application windows.
  • Use Case: Automate the process of logging into a web application by scripting peekaboo commands to open the browser, navigate to the login page, fill in credentials, and click the login button.

Quick Start

Run peekaboo permissions to check necessary macOS permissions for the tool.

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

Automating macOS UI interactions from the command line involves scripting UI element targeting, input simulation, and application control to execute deterministic workflows. This approach enables clicking, typing, and dragging through system interfaces programmatically.

Can I script screen capture and UI analysis on macOS?

Yes, you can script screen capture and UI analysis on macOS to capture screenshots, record video, and analyze UI elements programmatically. This allows for automated visual verification and element inspection within deterministic workflows.

What macOS permissions are required for UI automation scripting?

macOS UI automation scripting requires Screen Recording and Accessibility permissions on the host system. You can verify these necessary permissions by running a specific permissions check command before beginning your automation tasks.

How do I manage application windows using a CLI on macOS?

You can manage application windows using a CLI on macOS by scripting commands to launch, quit, focus, and manipulate windows. This allows for precise application control and window manipulation within automated workflows.

Are there limitations when automating macOS user interfaces via CLI?

Automating macOS user interfaces via CLI is limited by the host system's Screen Recording and Accessibility permissions. Without these explicitly granted system permissions, the scripting tool cannot target UI elements or simulate inputs effectively.