用途：Peekaboo 是面向 macOS 的完整 UI 自动化 CLI，用于截屏与检查屏幕、定位 UI 元素、驱动输入，以及管理应用、窗口和菜单。命令共享快照缓存，支持 --json/-j 便于脚本化。运行 peekaboo 或 peekaboo <cmd> --help 查看参数，peekaboo --version 打印构建信息。
主要能力：核心命令包括 bridge（检查 Peekaboo Bridge 连接）、capture（实时捕获或视频导入与抽帧）、clean、config、image（截取屏幕/窗口/菜单栏区域）、learn、list（应用、窗口、屏幕、菜单栏、权限）、permissions、run（执行 .peekaboo.json 脚本）、sleep、tools。交互命令有 click、drag、hotkey、move、paste、press、scroll、swipe、type。系统命令有 app、clipboard、dialog、dock、menu、menubar、open、space、visualizer、window。视觉命令 see 可生成带标注的 UI 地图与快照 ID，并可选分析。
使用方式：典型流程为 peekaboo permissions、peekaboo list apps --json、peekaboo see --annotate --path /tmp/peekaboo-see.png、peekaboo click --on B1、peekaboo type "Hello" --return。多数交互命令支持 --app、--pid、--window-title、--window-id、--window-index、--snapshot、--on/--id、--coords 等定位参数，以及 --no-auto-focus、--space-switch 等焦点控制。截图支持 --path、--format、--retina、--mode、--analyze、--annotate、--capture-engine。动作支持 --duration、--steps、--delay、--profile、--wpm、--direction、--amount、--smooth 等。
适用场景：需要以脚本方式自动化 macOS 界面操作、截图分析、菜单与窗口管理、鼠标键盘模拟的任务。
限制：需要屏幕录制与辅助功能权限；点击前建议先用 peekaboo see --annotate 识别目标。资料未提供收费、价格与平台支持范围等信息。