peekaboo

Automate macOS UI interactions via command-line interface.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/Deskaunedsei1983/loc_clawdbot_01 --skill peekaboo-deskaunedsei1983
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/Deskaunedsei1983/loc_clawdbot_01/tree/main/skills/peekaboo
Command: npx skills add https://github.com/Deskaunedsei1983/loc_clawdbot_01 --skill peekaboo-deskaunedsei1983

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates interactions with macOS graphical user interfaces, enabling scripting of complex UI tasks that would otherwise require manual input.

Core Features & Use Cases

  • UI Automation: Capture screens, inspect UI elements, and drive mouse/keyboard input.
  • App & Window Management: Launch, quit, and manipulate applications and their windows.
  • Use Case: Automate the process of filling out a multi-step form in a desktop application by using Peekaboo to navigate fields, enter data, and click buttons.

Quick Start

Run peekaboo permissions to check your macOS permissions for Screen Recording and Accessibility.

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?

You can automate macOS UI interactions from the command line by scripting screen capture, element targeting, and mouse/keyboard input. This CLI approach enables automating complex graphical tasks like filling multi-step desktop forms without manual input.

Do I need special permissions to control macOS GUI elements via scripting?

Yes, controlling macOS GUI elements via scripting requires specific system permissions for Screen Recording and Accessibility. You can verify your current authorization status by running the `peekaboo permissions` command before attempting any automation.

Can I manage applications and windows using macOS UI automation?

Yes, macOS UI automation allows you to manage applications and windows by launching, quitting, and manipulating them programmatically. You can drive desktop app workflows by inspecting UI elements and simulating targeted input.

What is the best way to automate filling out a multi-step form in a desktop application?

The best way to automate filling multi-step desktop forms is using a CLI tool to navigate fields, enter data, and click buttons. This scriptable UI automation captures the screen and targets elements to drive the application workflow automatically.

Why is my macOS UI automation script not working properly?

Your macOS UI automation script may not work if the required Screen Recording and Accessibility permissions are missing. Without these system-level authorizations, the automation cannot capture screens or successfully simulate mouse and keyboard input.