Peekaboo

Use for macOS screen capture, UI inspection, and GUI automation.

Binary

• Prefer ~/bin/peekaboo when present; it is Peter's local release copy.
• Else use peekaboo.
• Check first: ~/bin/peekaboo --version || peekaboo --version.

Safety

• Check permissions before capture/automation: peekaboo permissions status --json.
• Screenshot needs Screen Recording; clicks/typing/window control need Accessibility.
• On remote Macs, Screenshot may be blocked by missing Screen Recording while clicks/typing still work through Accessibility; continue with clicks or DOM automation when the target is otherwise knowable.
• Prefer --json for machine parsing and --no-remote when testing local TCC.
• Do not click/type/destructively automate unless user asked or target is a controlled test.