peekaboo

Automate macOS UI interactions and screen capture via the Peekaboo CLI.

1|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/zkcpku/verdentClaw --skill peekaboo-zkcpku
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/zkcpku/verdentClaw/tree/main/skills/peekaboo
Command: npx skills add https://github.com/zkcpku/verdentClaw --skill peekaboo-zkcpku

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates tedious and repetitive interactions with the macOS graphical user interface, allowing for programmatic control of applications and system elements.

Core Features & Use Cases

  • UI Automation: Control clicks, typing, drags, and other interactions with UI elements.
  • Screen Capture & Analysis: Capture screenshots, record screen activity, and analyze visual content.
  • App & Window Management: Launch, quit, focus, and manipulate application windows.
  • Use Case: Automate the process of logging into a web application by having Peekaboo open the browser, type the username and password, and click the login button.

Quick Start

Use the peekaboo skill to check 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 like clicking and typing programmatically?

You can automate macOS UI interactions by using the Peekaboo CLI to simulate inputs such as clicks, typing, and drags on targeted screen elements. This allows programmatic control over applications for repetitive tasks.

Can I capture screenshots and analyze screen content during a macOS automation script?

Yes, macOS automation scripts can capture screenshots and analyze visual content using the Peekaboo CLI. It supports screen capture and visual analysis to verify UI states during automated workflows.

What do I need to set up before using a CLI tool for macOS GUI automation?

Before using macOS GUI automation, you need the 'peekaboo' binary installed and accessible in your system's PATH. You must also verify that screen recording and accessibility permissions are granted to the tool.

How do I manage application windows when automating macOS desktop workflows?

To manage application windows in macOS desktop workflows, the Peekaboo CLI provides commands to launch, quit, focus, and manipulate application windows. This enables seamless transitions between different app contexts.

What is the best way to script a web login flow using macOS UI automation?

The best way to script a web login flow with macOS UI automation is to use Peekaboo CLI to open the browser, target the input fields, type the username and password, and simulate a click on the login button.

Does macOS UI automation work for agentic workflows and advanced scripting?

Yes, macOS UI automation supports advanced scripting and agentic workflows by allowing programmatic element targeting, input simulation, and app management. It integrates visual analysis to enable dynamic UI interactions.