agent-browser 是面向 AI 智能体的浏览器自动化 CLI，适用于需要与网站交互的场景，例如导航页面、填写表单、点击按钮、截图等。
基本工作流：先用 agent-browser open <url> 打开页面，再用 agent-browser snapshot -i 获取可交互元素及其引用（如 @e1、@e2），随后用引用执行 click、fill、select 等操作，页面发生导航或 DOM 变化后需重新 snapshot 获取新引用。多条命令可用 && 串联，浏览器通过后台守护进程在命令间保持。
主要能力：导航（open、close）、快照与作用域快照、交互（click、fill、type、select、check、press、keyboard、scroll、tap、swipe）、信息获取（get text/url/title）、等待（元素、网络空闲、URL 模式、毫秒）、下载、截图（含 --annotate 标注模式）、导出 PDF、diff 比较页面状态与像素差异、表单提交、数据提取（支持 --json）。还支持命名会话并行运行、连接已有 Chrome（--auto-connect 或 --cdp）、暗色模式、可视化调试（--headed、highlight、record、profiler）、打开本地文件、iOS 模拟器（需 macOS、Xcode 和 Appium）。
认证与状态：可用 auth save/login 保存并复用凭据（LLM 不接触密码），或用 state save/load 持久化登录状态，也可用 --session-name 自动保存恢复 cookies 与 localStorage，并支持加密。
安全特性均为可选：--content-boundaries 包裹页面内容以区分不可信输出，域允许列表限制导航与子资源，动作策略文件限制操作，输出上限防止上下文溢出。
限制：引用在页面变化后失效，必须重新快照；默认不施加任何导航、动作或输出限制；默认 Playwright 超时 25 秒；等待应优先使用显式等待；用毕应关闭会话避免进程泄漏。复杂 JavaScript 建议使用 eval --stdin 或 -b 避免 shell 转义问题。iOS 真机需预先配置。其他细节暂未提供。