skills.rest
PotLock
PotLockOFFICIAL
Explore all skills by this author →
Website𝕏@potlock_GitHub

peekaboo

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
One-click install
npx skills add https://github.com/PotLock/foxfang --skill peekaboo-potlock
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
lehalpaullehalpaul

peekaboo

Automate macOS UI interactions and screen captures using the Peekaboo CLI tool.

Community
Advanced
abhiunixabhiunix
1

peekaboo

Automate macOS UI tasks via CLI with JSON output.

Community
Intermediate
hashintelhashintel
7

cli-cmux

Automate terminal pane control, layout configuration, and browser UI interactions.

Official
Advanced
pmcdowallpmcdowall

macos-computer-use

Control macOS desktop interfaces without stealing user input focus.

Community
Advanced