peekaboo

Automate macOS UI interactions via command-line interface.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with the macOS graphical user interface, allowing for programmatic control of applications, windows, and user input.

Core Features & Use Cases

  • UI Automation: Capture screenshots, inspect UI elements, and drive mouse and keyboard input.
  • Application Control: Launch, quit, and manage application windows and their states.
  • Use Case: Automate the process of filling out a complex form within a desktop application by using Peekaboo to locate fields, type in data, and click buttons.

Quick Start

Use the peekaboo skill to capture a screenshot of the frontmost window.

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?

To automate macOS UI interactions from the command line, you can use a CLI tool to programmatically control screen capture, target UI elements, simulate input, and manage application windows without a graphical interface.

Can I capture screenshots and inspect UI elements using a CLI on macOS?

Yes, you can capture screenshots and inspect UI elements on macOS using a CLI automation tool. It allows you to programmatically identify interface components and extract visual data for scripting workflows.

Do I need special permissions to control macOS applications via GUI automation?

Yes, macOS GUI automation requires Screen Recording and Accessibility permissions. These system-level permissions are necessary for the CLI tool to capture screen content and simulate mouse and keyboard input effectively.

What is the best way to automate filling out a complex form in a desktop application?

The best way to automate filling out a complex form in a desktop application is by using a macOS UI automation CLI to locate input fields, programmatically type in data, and trigger button clicks.

Can I launch and manage application windows programmatically on macOS?

Yes, you can launch, quit, and manage application windows programmatically on macOS. A CLI automation tool enables you to control application states and manipulate window behaviors directly from your scripts.

How does input simulation work for macOS GUI control?

Input simulation for macOS GUI control works by programmatically driving mouse movements and keyboard inputs. A CLI tool sends these simulated events to targeted UI elements to interact with applications.