peekaboo

Automate macOS UI interactions with screen capture and input simulation.

601|121|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/smallnest/goclaw --skill peekaboo-smallnest
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/smallnest/goclaw/tree/main/internal/builtin_skills/peekaboo
Command: npx skills add https://github.com/smallnest/goclaw --skill peekaboo-smallnest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the tedious and error-prone process of interacting with macOS graphical user interfaces, enabling efficient and reliable UI automation for various tasks.

Core Features & Use Cases

  • UI Automation: Control applications, windows, menus, and system dialogs.
  • Input Simulation: Simulate mouse clicks, drags, scrolls, and keyboard input.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze UI elements.
  • Use Case: Automate the process of filling out a complex multi-step form in a desktop application, ensuring accuracy and speed.

Quick Start

Use the peekaboo skill to capture a screenshot of the frontmost Safari window and save it to /tmp/safari_window.png.

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 like mouse clicks and keyboard input?

Automating macOS UI interactions requires simulating mouse clicks, drags, scrolls, and keyboard input to control applications and system dialogs. This approach enables efficient automation for complex multi-step desktop tasks.

Can I capture screenshots and analyze UI elements on macOS programmatically?

Capturing screenshots and analyzing UI elements on macOS involves using screen capture tools to record activity and target specific interface components. This enables automated visual verification and element identification within desktop applications.

What is the best way to navigate macOS system dialogs and application menus automatically?

Navigating macOS system dialogs and application menus automatically involves using UI automation tools that support window management and menu navigation. This allows scripts to control application flows and handle system-level dialog interactions reliably.

Do I need to install the peekaboo CLI tool to automate macOS desktop applications?

Automating macOS desktop applications with this Skill requires installing the peekaboo CLI tool on macOS systems. This dependency provides the necessary commands for input simulation, screen capture, and element targeting.

Does macOS UI automation work for filling out complex multi-step forms in desktop applications?

macOS UI automation works effectively for filling out complex multi-step forms in desktop applications by simulating user input and navigating interface elements. This ensures accuracy and speed for repetitive data entry tasks.

What are the limitations of using input simulation for macOS screen capture and element targeting?

Limitations of using input simulation for macOS screen capture and element targeting include dependency on the macOS environment and the peekaboo CLI tool. It requires a graphical user interface to function and cannot operate in headless server environments.