用途：agent-browser 是给 AI 智能体使用的浏览器自动化 CLI，适合需要与网站交互的任务，例如打开页面、填写表单、点击按钮、截图、抓取页面文本等。
核心工作流：先 open 打开 URL，再用 snapshot -i 获取带引用的交互元素（如 @e1、@e2），然后用引用执行 click、fill、select 等操作；页面或 DOM 变化后必须重新 snapshot 获取新引用。示例：agent-browser open https://example.com/form，agent-browser snapshot -i，agent-browser fill @e1 "user@example.com"，agent-browser click @e3，agent-browser wait --load networkidle。
主要能力：导航（open、close，open 有 goto、navigate 别名）；快照（snapshot -i 列出交互元素引用，-C 含光标交互元素，-s 限定 CSS 选择器）；交互（click、fill 清空后输入、type 直接输入、select、check、press、scroll）；获取信息（get text、get url、get title）；等待（wait @e1、wait --load networkidle、wait --url 模式、wait 毫秒）；捕获（screenshot、screenshot --full、pdf 输出）。还支持 state save/load 持久化登录状态、--session 并行会话、session list、--headed 可视化调试、highlight 高亮元素、record start 录制会话，以及 --allow-file-access 打开本地 PDF/HTML 并截图。
iOS 模拟器：可用 agent-browser device list 列出设备，使用 -p ios --device "iPhone 16 Pro" open 启动移动 Safari，流程与桌面相同，支持 tap、swipe 等移动手势。要求 macOS 加 Xcode，以及 Appium（npm install -g appium 与 appium driver install xcuitest）；已预配置时可连接真实 iOS 设备，用 --device "<UDID>"（UDID 来自 xcrun xctrace list devices）。
语义定位：当引用不可用或不可靠时，可用 find text "Sign In" click、find label "Email" fill "..."、find role button click --name "Submit"、find placeholder "Search" type "..."、find testid "submit-btn" click。
限制与注意：引用在页面变化后会失效，链接跳转、表单提交、动态内容加载（下拉框、弹窗）后需重新快照；具体安装方式、版本与收费信息暂未提供。文档还包含 references 下的命令参考、快照引用、会话管理、认证、视频录制、代理支持等深入材料，以及 templates 下的表单自动化、认证会话、截图工作流脚本模板。