peekaboo

Automate macOS UI interactions by controlling apps, windows, and input via the Peekaboo CLI.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/rebootix-research/viki-clow --skill peekaboo-rebootix-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/rebootix-research/viki-clow/tree/main/skills/peekaboo
Command: npx skills add https://github.com/rebootix-research/viki-clow --skill peekaboo-rebootix-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automating macOS UI tasks is error-prone and time-consuming when done manually. Peekaboo provides a CLI-based solution to control apps, windows, and UI elements, enabling repeatable interactions and traceable results.

Core Features & Use Cases

  • Full macOS UI automation via a CLI to inspect, interact with, and verify UI states.
  • See/record proof of actions and outcomes for audits, testing, and demos.
  • Quick-start scenarios include targeting windows, performing clicks, and typing text across apps.

Quick Start

Install Peekaboo on macOS and run a simple automation command to verify UI actions.

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

macOS UI automation can be executed via a CLI to control apps, windows, and input events, reducing manual work. The Peekaboo CLI serves as the execution engine for scripted scenarios.

Can I record proof of automated GUI testing actions on macOS?

Yes, you can see and record proof of UI actions and outcomes for audits, testing, and demos. This provides traceable results and visible verification of automated interactions.

Do I need specific macOS permissions to run UI automation scripts?

Yes, macOS UI automation requires granting Screen Recording and Accessibility permissions. These authorize the CLI engine to control windows, inspect UI elements, and simulate input.

What is the best way to script routine UI tasks across multiple macOS apps?

Scripting routine UI tasks is best handled by targeting specific windows to perform clicks and type text across apps. This approach enables repeatable interactions for GUI testing.

Does CLI-based macOS UI automation work for verifying window states?

Yes, CLI-based macOS UI automation allows you to inspect, interact with, and verify UI states. This enables traceable validation of application windows and interface elements.