peekaboo

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

Updated Jan 29, 2026

Search Tags:#accessibility #macos #scripting #ui automation #peekaboo #gui testing

Ready to run

npx skills add https://github.com/douglasjs/clawdbot_plugin_tools --skill peekaboo-douglasjs

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/douglasjs/clawdbot_plugin_tools/tree/main/peekaboo
Command: npx skills add https://github.com/douglasjs/clawdbot_plugin_tools --skill peekaboo-douglasjs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the tedious and error-prone process of interacting with macOS graphical user interfaces, enabling scripting and automation of complex UI tasks.

Core Features & Use Cases

UI Inspection: Capture screenshots, inspect UI elements, and identify them for automation.
Interaction: Programmatically click, type, drag, and perform other user interactions.
App Management: Launch, quit, and manage application windows and states.
Use Case: Automate the process of filling out a complex multi-step form in a desktop application, ensuring consistency and speed.

Quick Start

Run peekaboo permissions to check and grant necessary macOS permissions.

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 for desktop application testing?▼

Automating macOS UI interactions requires simulating user inputs like clicks and typing while identifying on-screen elements programmatically. This Skill uses the Peekaboo CLI to capture screenshots, inspect UI elements, and execute deterministic task automation for GUI testing and scripting.

Do I need special permissions to run macOS UI automation scripts?▼

Yes, macOS UI automation requires Screen Recording and Accessibility permissions to function fully. You can check and grant these necessary macOS permissions by running the `peekaboo permissions` command before attempting to automate interactions or capture screens.

Can I automate filling out complex multi-step forms in a desktop application?▼

Yes, you can automate filling out complex multi-step forms in a desktop application by programmatically targeting UI elements, simulating typing, and managing application windows. This ensures consistency and speed while automating tedious, error-prone graphical user interface tasks.

What is the best way to capture screenshots and inspect UI elements on macOS?▼

Capturing screenshots and inspecting UI elements on macOS is best handled through dedicated UI automation scripting. This Skill leverages the Peekaboo CLI to perform visual analysis, identify elements for automation, and execute deterministic screen captures.

Does this macOS UI automation approach support application window management?▼

Yes, macOS UI automation supports application window management by allowing you to programmatically launch, quit, and manage application states. This enables deterministic task execution and seamless integration within larger automated scripting workflows.

Why is my macOS GUI testing script not triggering user interactions correctly?▼

macOS GUI testing scripts fail to trigger user interactions correctly when Screen Recording and Accessibility permissions are missing. Ensure you run `peekaboo permissions` to grant the necessary macOS access required for full UI automation and input simulation functionality.