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 --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 - 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 - permissions : check Screen Recording/Accessibility status - run : execute .peekaboo.json scripts - sleep : pause execution for a duration - tools : list available tools with filtering/display options - click : target by ID/query/coords with smart waits - drag : drag & drop across elements/coords/Dock - hotkey : modifier combos like cmd,shift,t - move : cursor positioning with optional smoothing - paste : set clipboard -> paste -> restore - press : special-key sequences with repeats - scroll : directional scrolling (targeted + smooth) - swipe : gesture-style drags between targets - type : text +...