peekaboo

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with the macOS graphical user interface, streamlining repetitive tasks and enabling programmatic control of applications and system elements.

Core Features & Use Cases

  • UI Automation: Control applications, windows, menus, and system dialogs.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
  • Input Simulation: Simulate mouse clicks, drags, scrolls, and keyboard input.
  • Use Case: Automate the process of logging into a web application by launching the browser, navigating to the login page, filling in credentials, and submitting the form.

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?

macOS UI automation is achieved by using the Peekaboo CLI to script application launches, window management, and user input simulation. This enables programmatic control over repetitive graphical interface tasks directly from the command line.

Can I capture a screenshot of a specific window or screen region on macOS?

Capturing screenshots of specific windows or screen regions is supported by the Peekaboo CLI. It allows grabbing full screens or targeted areas and includes options for analyzing the visual content of the captured image.

Do I need to install any dependencies to use this macOS automation tool?

Yes, installing the 'peekaboo' binary and making it accessible in your system's PATH is required. This external command-line tool acts as the core engine to execute the UI automation and screen capture commands.

What is the best way to simulate mouse and keyboard input on a Mac?

The best way to simulate mouse and keyboard input on a Mac is via the Peekaboo CLI, which supports simulating clicks, drags, scrolls, and keystrokes to programmatically interact with system dialogs and applications.

How does screen capture and analysis work for automated testing?

Screen capture and analysis for automated testing works by taking screenshots of the frontmost window or screen and optionally analyzing the visual content. This allows scripts to verify UI states by inspecting the captured graphical output.

Are there limitations when automating system dialogs and menus on macOS?

Automating system dialogs and menus depends on the peekaboo binary being present in the system PATH. Limitations may arise if the target application restricts programmatic access or if the required binary is not installed correctly.