agent-browser 是面向 AI 智能体的浏览器自动化 CLI，用于与网站交互，如导航页面、填写表单、点击按钮、截图抓取数据。
核心工作流：open 打开 URL → snapshot -i 获取元素引用（如 @e1、@e2）→ 用引用执行 click、fill、select → 页面变化后重新 snapshot 获取新引用。命令可用 && 串联，浏览器通过后台守护进程保持状态。
主要能力：导航与关闭（open、close）；快照（snapshot -i、-C 含光标可交互元素、-s 限定选择器）；交互（click、fill、type、select、check、press、scroll）；信息获取（get text/url/title）；等待（元素、networkidle、URL 模式、毫秒）；截图与 PDF（screenshot、--full、--annotate、pdf）。
常用模式包含表单提交、带状态持久化的登录流程、会话持久化（--session-name、state save/load/list/clear/clean）、数据抽取（get text、--json）、并行会话（--session）、连接已有 Chrome（--auto-connect、--cdp）、可视化调试（--headed、highlight、record、profiler）、本地文件（--allow-file-access、file://）以及 iOS 模拟器（-p ios、--device）。
引用（@e1 等）在页面变化后失效，点击跳转、提交表单、动态内容加载后必须重新 snapshot。复杂 JavaScript 用 eval --stdin 或 -b 避免 shell 转义问题。可在项目根目录创建 agent-browser.json 配置，优先级为全局配置 < 项目配置 < 环境变量 < CLI 标志。慢页面建议用显式等待。完成后应 close 会话避免进程泄漏。iOS 模拟器需 macOS、Xcode 与 Appium。具体收费与平台支持细节暂未提供。