peekaboo

Installation
Summary

macOS UI automation CLI for screen capture, element targeting, and input control.

  • Covers 30+ commands across screen capture, UI inspection, app/window management, interaction (click, drag, type, scroll), and system control (menus, Dock, dialogs, clipboard)
  • Targets UI elements by ID, query, or coordinates; supports snapshot caching and --json output for scripting
  • Includes vision capabilities (see command) for annotated UI maps and optional AI analysis of screen content
  • Requires Screen Recording and Accessibility permissions; runs natively on macOS via CLI with optional Peekaboo Bridge for remote connectivity
SKILL.md

Peekaboo

Peekaboo is a full macOS UI automation CLI: capture/inspect screens, target UI elements, drive input, and manage apps/windows/menus. Commands share a snapshot cache and support --json/-j for scripting. Run peekaboo or peekaboo <cmd> --help for flags; peekaboo --version prints build metadata. Tip: run via polter peekaboo to ensure fresh builds.

Features (all CLI capabilities, excluding agent/MCP)

Core

  • bridge: inspect Peekaboo Bridge host connectivity
  • capture: live capture or video ingest + frame extraction
  • clean: prune snapshot cache and temp files
  • config: init/show/edit/validate, providers, models, credentials
  • image: capture screenshots (screen/window/menu bar regions)
  • learn: print the full agent guide + tool catalog
  • list: apps, windows, screens, menubar, permissions
Related skills
Installs
1.9K
GitHub Stars
371.6K
First Seen
Jan 24, 2026