peekaboo

Name: peekaboo
Availability: InStock
Author: POTLOCK

Automate macOS UI interactions using the Peekaboo CLI.

Updated Aug 23, 2026

Search Tags:#automation #cli #macos #window-management #screen-capture #ui-automation #element-targeting

Ready to run

npx skills add https://github.com/PotLock/foxfang --skill peekaboo-potlock

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/PotLock/foxfang/tree/main/skills/peekaboo
Command: npx skills add https://github.com/PotLock/foxfang --skill peekaboo-potlock

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo reduces manual macOS UI automation by providing a CLI to capture, inspect, target UI elements, drive input, and manage apps, windows, and menus.

Core Features & Use Cases

Capture and inspect the screen, target UI elements, and drive input across macOS apps.
Scriptable UI automation with snapshot caching and JSON-friendly commands for integration into workflows.
Manage apps, windows, menus, and common UI tasks from the terminal to automate repetitive interactions.

Quick Start

Install Peekaboo on macOS, grant the necessary permissions, and start automating UI tasks with commands like 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 tasks from the terminal?▼

You can automate macOS UI interactions using the Peekaboo CLI to capture screens, target UI elements, and simulate input. It provides commands like see, click, and type to script repetitive desktop app interactions directly from your terminal.

What permissions do I need to control macOS desktop apps via command line?▼

To control macOS desktop apps via command line, you need a macOS environment with accessibility and screen recording permissions granted to your terminal. These permissions allow the CLI to inspect UI elements, capture screens, and simulate inputs across applications.

Can I script window management and screen capture for macOS apps using JSON?▼

Yes, you can script window management and screen capture using the CLI's JSON-friendly commands. The tool supports scripting via the --json flag, enabling snapshot caching and integration into automated workflows for managing apps, windows, and menus.

What's the best way to inspect and target UI elements for GUI automation on macOS?▼

The best way to inspect and target UI elements for macOS GUI automation is using the CLI's see command. It allows you to capture the screen, identify specific elements, and then apply actions like click or type to interact with them programmatically.

Does macOS CLI automation work for managing app menus and windows?▼

Yes, macOS CLI automation supports managing apps, windows, and menus. The tool provides specific commands to handle common UI tasks, allowing you to drive input and control application interfaces from the terminal without manual interaction.