skills.rest
lllooollpp
lllooollppCOMMUNITY
Explore all skills by this author →
GitHub

peekaboo

Automate macOS UI interactions, screen capture, and application control via command-line interface.

39|10|Updated Jan 27, 2026
Search Tags:#testing#cli#macos#scripting#ui automation#screen capture
One-click install
npx skills add https://github.com/lllooollpp/clawdbot-cn --skill peekaboo-lllooollpp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/lllooollpp/clawdbot-cn/tree/main/skills/peekaboo
Command: npx skills add https://github.com/lllooollpp/clawdbot-cn --skill peekaboo-lllooollpp

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.
  • Screen Capture & Analysis: Capture screenshots, record video, and analyze UI content.
  • App & Window Management: Launch, quit, focus, and manipulate application windows.
  • Use Case: Automate repetitive tasks like filling out forms in a desktop application, testing UI flows, or capturing specific screen regions for documentation.

Quick Start

Run peekaboo to check your 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 from the command line by using a CLI tool to script element targeting, input simulation, and window management. It enables programmatic control over applications and user input without manual clicking.

What permissions do I need for macOS UI automation scripting?▼

macOS UI automation scripting requires Screen Recording and Accessibility permissions. You must grant these in your system settings to allow the CLI tool to capture screen content and simulate user input on the interface.

Can I capture screenshots and record video via a macOS CLI?▼

Yes, you can capture screenshots and record video via a macOS CLI. The tool supports screen capture and visual analysis, allowing you to grab specific screen regions for documentation or testing workflows programmatically.

What is the best way to test desktop application UI flows on macOS?▼

The best way to test desktop application UI flows on macOS is using a dedicated CLI for UI automation. It supports launching apps, targeting elements, simulating inputs, and capturing screens to validate repetitive form submissions or interface behaviors.

Does macOS UI automation support window management and app control?▼

Yes, macOS UI automation supports window management and app control. You can programmatically launch, quit, focus, and manipulate application windows directly from your scripts to streamline complex desktop workflows.

Why is my macOS screen capture automation not working?▼

Your macOS screen capture automation may not work if Screen Recording and Accessibility permissions are missing. You must explicitly grant these system permissions for the CLI to access UI elements and capture visual content.

Related Skills

Explore More Software Engineering Skills→
lehalpaullehalpaul

peekaboo

Automate macOS UI interactions and screen captures using the Peekaboo CLI tool.

Community
Advanced
traylinxtraylinx
2

vision-expert

Analyze images and screenshots to extract layout patterns, UI components, and diagrams.

Official
Advanced
edwinhuedwinhu
19

dev-test-hammerspoon

Automate macOS applications and desktop workflows using the Hammerspoon scripting engine.

Community
Advanced
rafaelcallejarafaelcalleja
2

gemini-cli

Interact with Gemini AI models through a command-line interface.

Community
Intermediate