用途：Peekaboo 是一个完整的 macOS UI 自动化 CLI，用于捕获与检查屏幕、定位界面元素、驱动输入，并管理应用、窗口与菜单。
主要能力：核心命令包括 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 或 peekaboo <cmd> --help 查看参数，peekaboo --version 打印构建元数据；可提示通过 polter peekaboo 确保使用新构建。典型流程：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 等定位参数；截图支持 --path、--format、--retina、--mode、--analyze、--annotate、--capture-engine 等；动作支持 --duration、--steps、--delay、--profile、--wpm、--direction、--amount、--smooth 等。
适用场景：需要以脚本方式自动操作 macOS 应用与窗口、批量截图与分析界面、模拟键盘鼠标输入的场合。
限制：需授予屏幕录制与辅助功能权限；官方建议先用 peekaboo see --annotate 识别目标再点击。其他收费、平台或效果信息暂未提供。