peekaboo

Automates macOS UI interactions and screen captures via Peekaboo CLI.

16|1|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/Flexasaurusrex/OpenPaw --skill peekaboo-flexasaurusrex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Flexasaurusrex/OpenPaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/Flexasaurusrex/OpenPaw --skill peekaboo-flexasaurusrex

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 Element Interaction: Click, type, drag, and scroll through UI elements using robust targeting.
  • 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 logging into a desktop application, filling out a form, and taking a screenshot of the result.

Quick Start

Run peekaboo to check permissions for screen recording and accessibility.

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?

You can automate macOS UI interactions by running the Peekaboo CLI to simulate clicks, typing, dragging, and scrolling through targeted UI elements. It enables programmatic control of applications and windows directly from scripts or agentic workflows.

Why does macOS UI automation fail without permissions?

macOS UI automation fails without permissions because the system restricts programmatic control for security. You must explicitly grant Screen Recording and Accessibility permissions to your terminal or automation tool to allow the Peekaboo CLI to capture screens and simulate input.

Can I capture screenshots and record screen activity on macOS via CLI?

Yes, you can capture screenshots and record screen activity on macOS via CLI. The Peekaboo CLI supports screen capture and visual analysis, allowing you to programmatically grab screenshots of specific application windows or UI element states.

What is the best way to script desktop application testing on macOS?

The best way to script desktop application testing on macOS is using a CLI tool that supports UI element targeting and input simulation. You can automate logging into an application, filling out forms, and capturing the result visually without manual intervention.

Does Peekaboo support window management and app launching for automated workflows?

Yes, Peekaboo supports window management and app launching for automated workflows. It allows you to programmatically launch, quit, focus, and manipulate application windows as part of a larger UI automation or GUI testing script.

How do I check if my macOS environment is ready for UI automation?

To check if your macOS environment is ready for UI automation, run the peekaboo command. It will verify whether the necessary Screen Recording and Accessibility permissions are granted for full functionality of the automation CLI.