peekaboo

Automate macOS UI interactions and screenshot capture via CLI.

Updated Dec 31, 2025
One-click install
npx skills add https://github.com/diegopetrucci/ios-agents-skills --skill peekaboo-diegopetrucci
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/diegopetrucci/ios-agents-skills/tree/main/peekaboo
Command: npx skills add https://github.com/diegopetrucci/ios-agents-skills --skill peekaboo-diegopetrucci

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Automates macOS UI interactions and screenshot capture to save time and reduce manual repetitive tasks when working with macOS applications.

Core Features & Use Cases

  • Screen capture with UI element annotations and accessibility IDs to facilitate precise interactions.
  • UI automation: click, type, scroll, and navigate UI elements and dialogs.
  • Application and window control: launch, focus, move, resize, and switch between apps.
  • Workflow automation: compose multi-step sequences and AI-assisted tasks.

Quick Start

Install Peekaboo via Homebrew and run a basic capture of the current screen to begin automating macOS workflows.

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 and screenshot capture for repetitive tasks?

You can automate macOS UI interactions by using a CLI workflow to capture screens, interact with elements, and control windows. This streamlines repetitive tasks like QA, accessibility testing, and productivity workflows across macOS apps.

What macOS permissions do I need to automate UI tasks and capture screenshots?

To automate UI tasks and capture screenshots, you need macOS 15.0+ with Screen Recording and Accessibility permissions enabled. These system-level permissions allow the automation tool to interact with UI elements and capture screen content.

Can I use macOS UI automation for accessibility testing?

Yes, macOS UI automation supports accessibility testing by capturing screens with UI element annotations and accessibility IDs. This allows you to navigate dialogs, click elements, and verify application behavior for accessibility compliance.

What is the best way to compose multi-step workflows for macOS applications?

The best way to compose multi-step workflows is by using a CLI workflow that combines screen capture, element interaction, and application control. You can launch, focus, move, resize apps, and sequence AI-assisted tasks.

Does macOS UI automation support clicking, typing, and scrolling within dialogs?

Yes, macOS UI automation supports clicking, typing, scrolling, and navigating UI elements and dialogs. It leverages system APIs to interact directly with application interfaces and streamline repetitive input tasks.