peekaboo

macOS UI automation CLI for screen capture, element targeting, and input control. 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 --help for flags; peekaboo --version prints build metadata. Tip: run via polter peekaboo to ensure fresh builds. Core Interaction System Vision Global runtime flags Notes - 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 - 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,...