使用指南
面向 Agent 与终端的 Browser CLI
面向 Agent 与终端的 Browser CLI.
安装并授权
CLI 使用 Python 3.11 或更高版本和 uv，从维护仓库安装：
uv tool install --force git+https://github.com/lexmount/browser-cli.git
browser-cli --version
browser-cli auth login --open
browser-cli auth status
browser-cli doctor --json在浏览器能访问本机回调地址的机器上运行登录。浏览器授权流程把凭据保存在本地，不要粘贴到聊天。无界面环境可通过 browser-cli auth login --help 查看支持的替代方式。已有 API Key 时，可使用开始使用中的环境变量。
创建、检查与关闭
browser-cli session create --browser-mode normal把返回的会话 ID 填入 SESSION_ID，不要填带认证信息的连接 URL：
set -eu
SESSION_ID='replace-with-returned-session-id'
trap 'browser-cli session close --session-id "$SESSION_ID"' EXIT
browser-cli action open-url --session-id "$SESSION_ID" --url https://example.com --wait-until domcontentloaded
browser-cli action page-info --session-id "$SESSION_ID"
browser-cli action snapshot --session-id "$SESSION_ID" --max-chars 4000
browser-cli session close --session-id "$SESSION_ID"
trap - EXIT替换会话 ID 后，把代码块保存为 inspect.sh 并运行 bash inspect.sh。页面标题应为 Example Domain。操作失败时 EXIT trap 关闭会话，成功时由最后的 close 关闭。进程或机器被强制终止后，应在控制台检查遗留会话。
按安装版本发现能力
通过 browser-cli action --help 和 browser-cli action <command> --help 查看参数，browser-cli commands --names-only 查看命令路径。Agent 应先观察、操作、再观察，不要假定点击已经成功。快照是页面观察结果，不是交易完成的证明。
报告问题时附 CLI/runtime 版本。共享日志不要使用 --reveal-connect-url。CLI 提供某操作不代表目标网站允许访问，也不表示每种浏览器模式都支持它。