Agent skill · software engineering · steipete
peekaboo
Capture and automate macOS UI with the Peekaboo CLI.
Why this skill is useful
Adds executable scripts for automating macOS UI interactions that the AI cannot generate from existing knowledge.
What it needs
Requires brew, peekaboo installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 385,400 stars on the source repository.
What this skill does
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: Confirm that the selected host and socket are the intended ones. Preserve an explicit PEEKABOOBRIDGESOCKET 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. Find the installed command Use leaf help for flags and targeting requirements instead of copying a flag between commands. Use root help to discover the available commands: V4 removed these old command roots: Old command V4 command ----------- -------------------------------------------------------- list apps app list image see --no-elements for pixels without element detection hotkey press with chords such as cmd+shift+t swipe drag --from … --to … For other operations, including clicking, typing, scrolling, and managing windows or menus, use peekaboo <command> --help. Put command options after the leaf command; --json requests structured output. Inspect, act, verify Start with application inventory and a fresh view of the target: Read the returned elements before acting. Keep actions tied to the intended app, window, and fresh snapshot; do not reuse example element IDs. After an action, inspect the UI again and check the requested result. Refresh the observation when the window changes or a target becomes stale. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/peekaboo--d32a85