peekaboo

Automate macOS UI tasks via CLI for app, window, and element interaction.

2.5k|423|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/Bitterbot-AI/bitterbot-desktop --skill peekaboo-bitterbot-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Bitterbot-AI/bitterbot-desktop/tree/main/skills/peekaboo
Command: npx skills add https://github.com/Bitterbot-AI/bitterbot-desktop --skill peekaboo-bitterbot-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS UI automation often requires repetitive, error-prone manual steps to interact with apps, windows, and controls. Peekaboo provides a CLI that enables scripted, repeatable automation of UI tasks, including capturing annotated visuals and controlling UI elements.

Core Features & Use Cases

  • Automate UI interactions: inspect UI elements, click by ID, type text, and drive input.
  • Manage apps and windows: launch, focus, resize, and navigate menus and the Dock.
  • Screen capture and analysis: take annotated screenshots and operate with a shared snapshot cache for scripting.
  • Quick-start-oriented: combine commands to build end-to-end automation flows for macOS apps.

Quick Start

Install the Peekaboo CLI on macOS, grant the necessary Accessibility permissions, and start automating UI tasks with see, 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 interactions like clicking and typing from the command line?

Yes, you can capture annotated screenshots on macOS using a CLI that supports visual analysis and a shared snapshot cache. This allows scripts to inspect UI elements and capture visuals for automated testing workflows.

What do I need to set up before scripting macOS window management and app automation?

macOS UI automation via CLI targets UI elements by app, window, or element ID. This approach lets you inspect properties, click specific controls, and type input directly into targeted applications.

Can I capture annotated screenshots during an automated macOS UI workflow?

You need to install the Peekaboo CLI binary on macOS and grant Accessibility permissions. Once configured, you can launch, focus, resize windows, and navigate menus programmatically.

How does command line UI automation target specific elements on macOS?

You can automate macOS UI interactions using a CLI to inspect elements, click targets by ID, and type text. This enables scripted, repeatable automation of repetitive UI tasks without manual input.