peekaboo

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

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/Rachasumanth/text2llm001 --skill peekaboo-rachasumanth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Rachasumanth/text2llm001/tree/main/skills/peekaboo
Command: npx skills add https://github.com/Rachasumanth/text2llm001 --skill peekaboo-rachasumanth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with the macOS graphical user interface, enabling complex UI-driven tasks to be performed programmatically.

Core Features & Use Cases

  • UI Element Interaction: Click, type, drag, and scroll through UI elements with precision.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
  • App & Window Management: Launch, quit, focus, and manipulate application windows.
  • Use Case: Automate the process of filling out a complex software installation wizard or regularly extract data from specific UI elements of an application that lacks an API.

Quick Start

Run peekaboo permissions to check for necessary macOS permissions.

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 for desktop apps lacking an API?

You can automate macOS UI interactions by using a CLI tool to programmatically click, type, drag, and scroll through interface elements. This allows complex UI-driven tasks to run automatically without manual input.

What macOS permissions are required for GUI automation and screen capture scripting?

macOS GUI automation and screen capture scripting require both Screen Recording and Accessibility permissions. You can verify if these necessary permissions are granted by running the peekaboo permissions command.

Can I capture screenshots and analyze visual content during macOS automation workflows?

Yes, you can capture screenshots, record screen activity, and analyze visual content during macOS automation workflows. This visual analysis capability supports extracting specific data from UI elements.

How do I launch, focus, and manage application windows via command line scripting?

You can manage application windows via command line scripting by using window management commands to launch, quit, focus, and manipulate apps. This enables full programmatic control over the macOS graphical interface.

What is the best way to fill out complex software installation wizards automatically?

The best way to fill out complex software installation wizards automatically is to use UI element interaction to target specific buttons and inputs. This simulates precise mouse and keyboard inputs to progress through wizard steps.

Does UI automation work for extracting data from applications without an API?

Yes, UI automation works for extracting data from applications without an API by targeting specific UI elements and capturing their visual content. This bypasses the need for direct programmatic API access to gather needed information.