agent-browser 是一款面向 AI 智能体的浏览器自动化命令行工具，用于让智能体与网站交互，例如导航页面、填写表单、点击按钮、截图与提取数据。
核心工作流为：用 open 打开网址；用 snapshot -i 获取可交互元素引用（如 @e1、@e2）；用引用执行 click、fill、select 等交互；页面变化后重新快照以取得新引用。浏览器通过后台守护进程在命令间保持，可用 && 串联命令；读取中间输出时则分开执行。
主要能力包括：导航 open/close，快照 snapshot（-i、-C、-s），交互 click、fill、type、select、check、press、keyboard、scroll，信息获取 get text/url/title，等待 wait（元素、networkidle、URL、毫秒、JS 条件），下载 download 与下载等待，截图与 PDF，页面状态与截图差异对比，多会话并行，连接已有 Chrome，本地文件访问、iOS 模拟器、可视化调试与性能分析。
认证方面支持 Auth Vault 保存凭据（经 AGENT_BROWSER_ENCRYPTION_KEY 加密，可用密码经 stdin 传入避免泄露），以及 state save/load 与 --session-name 会话持久化。
安全特性均为可选：默认不限制导航、操作和输出。可启用 --content-boundaries 用标记包裹页面来源输出以帮助区分不可信内容，配置域名允许列表、操作策略文件、输出上限。使用中需注意引用在页面变化后会失效，应重新快照；并发时使用命名会话并及时 close；较慢页面建议用显式等待。配置可通过配置文件、环境变量与 CLI 标志设置，优先级依次递增。