peekaboo-click-patterns

Click Mac UI elements using stable AX tree element IDs.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/MCERQUA/jam-skills --skill peekaboo-click-patterns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo-click-patterns
Source: https://github.com/MCERQUA/jam-skills/tree/main/peekaboo-click-patterns
Command: npx skills add https://github.com/MCERQUA/jam-skills --skill peekaboo-click-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenges of UI automation on Mac by providing stable element IDs for clicking Mac UI elements, avoiding the issues with pixel coordinates and osascript keystrokes.

Core Features & Use Cases

  • Stable Element ID Clicking: Ensures consistent clicks on Mac UI elements using element IDs.
  • Dialog Handling: Manages visibility and handling of dialogs that require specific timing.
  • ID Extraction: Extracts element IDs from the AX tree for use in automated scripts.
  • Use Case: Automating tasks like signing into accounts or dismissing dialog boxes on Mac systems.

Quick Start

Execute the 'peekaboo click --on elem_42' command to click a UI element identified by its stable element ID 'elem_42'.

Frequently Asked Questions about peekaboo-click-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Mac UI clicks without using pixel coordinates?

Mac UI automation can be achieved using stable element IDs extracted from the AX tree, which ensures consistent clicks on UI elements without relying on fragile pixel coordinates or osascript keystrokes.

What is the best way to handle dialog boxes in macOS automation scripts?

Dialog handling in macOS automation is best managed using stable element IDs that account for element visibility and specific timing requirements, ensuring reliable interaction with dialog boxes during automated workflows.

How do I extract element IDs from the AX tree for macOS UI automation?

Element IDs are extracted from the AX tree to provide stable references for automated scripts, allowing you to target Mac UI elements consistently and execute click operations on them.

Can I use stable element IDs to click UI elements on Mac systems?

Yes, stable element IDs from the AX tree can be used to click Mac UI elements, providing a reliable alternative to pixel coordinates for automation scripts that require consistent element references.

Why do my macOS automation scripts fail when clicking UI elements with osascript keystrokes?

macOS automation scripts using osascript keystrokes often fail due to unstable element references; using stable element IDs from the AX tree resolves this by ensuring consistent clicks on Mac UI elements.