peekaboo

Automate macOS UI tasks by commanding Peekaboo to inspect and interact with elements.

117|8|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/geezerrrr/motive --skill peekaboo-geezerrrr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/geezerrrr/motive/tree/main/Motive/Resources/Skills.bundle/peekaboo
Command: npx skills add https://github.com/geezerrrr/motive --skill peekaboo-geezerrrr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo provides a full macOS UI automation CLI to inspect, target, and drive UI elements, enabling scripted control over apps and windows without manual clicking.

Core Features & Use Cases

  • UI inspection and targeting: identify elements on screen and retrieve properties for scripted use.
  • Action automation: perform clicks, keystrokes, and window/dock/menubar manipulations to drive apps.
  • Scripting and testing: build repeatable automation flows for macOS apps and system dialogs.
  • Visual feedback and validation: preview automation steps and verify outcomes with optional annotations.

Quick Start

Launch the Peekaboo CLI, identify a target with see, and automate actions with click and type.

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 tasks from the command line?

You can automate macOS UI tasks by using a command line interface to inspect on-screen elements and perform scripted interactions like clicks and keystrokes. This allows repeatable automation flows for applications and system dialogs without manual intervention.

What permissions do I need to script macOS UI interactions?

Scripting macOS UI interactions requires Accessibility and Screen Recording permissions granted to the CLI binary. Without these system-level permissions, the automation tool cannot inspect on-screen elements or execute synthetic clicks and keystrokes.

How do I inspect and target UI elements for macOS workflow automation?

To inspect and target UI elements for macOS workflow automation, you execute a see command to identify on-screen items and retrieve their properties. This allows your scripts to accurately locate and interact with buttons, windows, and system dialogs.

Can I build repeatable automation flows for macOS system dialogs?

Yes, you can build repeatable automation flows for macOS system dialogs by scripting UI inspections and interactions. This allows you to programmatically drive native macOS apps, window manipulations, and system prompts without manual clicking.

What are the limitations of using CLI scripting for macOS UI automation?

Limitations of CLI scripting for macOS UI automation include strict dependency on macOS Accessibility permissions and potential instability when targeting dynamically rendered UI elements. Visual feedback and validation steps are required to verify automation outcomes.