Peekaboo

This is a comprehensive macOS UI automation CLI that gives Claude direct control over your desktop. Instead of asking you to click things, Claude can capture annotated screenshots with element IDs, then click, type, drag, and navigate menus itself. The see-then-click workflow is notably practical: capture an annotated view, get element IDs, then target them directly. It covers the full scope from basic screenshots to window management, menu navigation, and even live motion-aware capture. Requires Screen Recording and Accessibility permissions, obviously. If you're building agents that need to interact with native Mac apps or automate complex UI workflows, this is the missing piece between Claude's reasoning and actual desktop control.

skills.sh installs: 3.4K
GitHub stars: 382.8K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add steipete/clawdis --skill peekaboo --agent claude-code

Installs into .claude/skills of the current project.

Files

Peekaboo

Use Peekaboo to inspect macOS UI, act on the intended target, and verify the result. The examples below use v4 syntax. Check peekaboo --version and the installed command's --help; for older versions, follow that version's help.

OpenClaw Bridge

The OpenClaw macOS app hosts Peekaboo Bridge when Computer Control is enabled, its provider is Peekaboo, and Peekaboo Bridge is enabled. Keep the existing OpenClaw socket selection when running through that host:

export PEEKABOO_BRIDGE_SOCKET="${PEEKABOO_BRIDGE_SOCKET:-$HOME/Library/Application Support/OpenClaw/bridge.sock}"
peekaboo bridge status --json

Confirm that the selected host and socket are the intended ones. Preserve an explicit PEEKABOO_BRIDGE_SOCKET or --bridge-socket selection. If the required host is unavailable, report that outcome; do not clear the selection or switch Computer Control providers to make a command succeed.

Permissions belong to the process or Bridge host performing the operation. Do not pass --no-remote unless the caller has the required permissions.