How does Peekaboo differ from Playwright?

While Playwright is primarily designed for web browser automation, Peekaboo is built specifically for native macOS desktop applications and system-level GUI automation.

Does Peekaboo support headless CI/CD environments?

Yes, Peekaboo includes a daemon mode that allows for headless execution and background automation, which is perfect for integration into CI/CD pipelines.

What permissions does Peekaboo require on macOS?

Peekaboo requires Screen Recording and Accessibility permissions within macOS System Settings to capture the UI and simulate user interactions effectively.

Why is the snapshot pattern recommended for clicking?

Using a snapshot ID ensures that the click action targets the exact element identified in a previous 'see' command, preventing bridge errors and ensuring the interaction happens on the correct window.

Can Peekaboo test apps without bundle IDs?

Yes, Peekaboo can target applications using PIDs (Process IDs), making it ideal for testing debug builds or unsigned macOS apps where standard targeting might fail.

Peekaboo Visual macOS Testing

Name: Peekaboo Visual macOS Testing
Author: ShravanSunder

byShravanSunder

0•

セキュリティとテスト

Automates visual UI testing and GUI interactions for native macOS applications using high-fidelity screen capture and AI analysis.

Peekaboo is a specialized macOS automation tool designed for developers and QA engineers who need to test native application UIs where web-based tools like Playwright fall short. It provides a robust CLI for capturing UI states, extracting element IDs, and performing precise interactions like clicking, typing, and keyboard navigation. Supporting both interactive and headless modes for CI/CD, Peekaboo excels at verifying debug builds, managing window focus, and automating complex macOS workflows through a reliable 'See-Interact-Verify' pattern that ensures interaction accuracy even across multiple application windows.

主な機能

01High-fidelity visual UI capture and element identification for native macOS apps.

02Headless mode via daemon for seamless CI/CD integration and background testing.

030 GitHub stars

04Built-in support for debug builds and unsigned apps without bundle IDs.

05Precise GUI automation including clicks, text input, and complex keyboard hotkeys.

06Robust targeting patterns using PIDs or snapshots to ensure interaction accuracy.

ユースケース

01Verifying visual UI states and element layouts in CI/CD pipelines.

02Automating end-to-end regression tests for native macOS desktop applications.

03Automating repetitive macOS system tasks and cross-app interactions.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add shravansunder/ai-tools peekaboo

For use in Claude.ai and ChatGPT

Download Skill