peekaboolisted

# Peekaboo (macOS UI Automation) Use the `peekaboo` bridge for full macOS UI automation: screenshots, clicks, typing, app/window management. ## When to Use - User asks to interact with a macOS app (click, type, screenshot) - Capturing what's on screen - Automating UI workflows - Managing windows, menus, Dock ## When NOT to Use - Tasks that can be done via API/CLI -> prefer the specific bridge/skill - Bulk automation -> consider AppleScript or Shortcuts instead ## Commands All commands run via `host_execute(bridge="peekaboo", command="...")`. ### See & Capture ``` peekaboo permissions # Check permissions peekaboo see --annotate --path /tmp/peekaboo-see.png # Annotated screenshot peekaboo image --mode screen --path /tmp/screen.png # Full screenshot peekaboo image --app Safari --analyze "Summarize the page" # Screenshot + analysis peekaboo list apps --json # List running apps peekaboo list windows --app Safari --json # List windows ``` ### Interact ``` peekaboo click --on B1 # Click element by ID peekaboo click --coords 500,300 # Click by coordinates peekaboo type "Hello" --return # Type text + Enter peekaboo hotkey --keys "cmd,shift,t" # Keyboard shortcut peekaboo scroll --direction down --amount 5 # Scroll ``