安装
需要 Node.js 22 或更高版本；npm 为可选。再次运行任一安装命令即可升级。身份认证
运行以下命令，通过浏览器登录，并保存工作空间的 API Key：GLASSER_API_KEY，或使用 glasser keys add。
命令
在侧栏选择命令，或打开下方参考页。每个命令页都列出了语法和选项。将相关调用归入同一个 Task
搜索会返回task_id。在相关搜索中通过 --task 传入该值，包括更换关键词重试、读取下一页，以及后续的 inspect 和 run。CLI 不会自动保存或复用 Task。即使传入了 --task，每次搜索仍必须提供 --use-case。
<taskId> 替换为响应中的 task_id。数据提供商、接口和输入应以搜索及检查结果为准。
--task，每次都会创建新 Task。在 inspect 和 run 中，省略该参数表示调用不归属任何 Task。在 runs list 中，--task 用于筛选指定 Task 的结果。
全局选项
所有命令均支持：-j/--json、--help、--version。
JSON 模式
使用-j/--json 时，stdout 中的命令结果为 JSON。成功时 stderr 为空，失败时包含一个 JSON 错误对象。显式使用 --help 和 --version 时，仍输出文本。
run --json必须提供--idempotency-key，以便使用同一个键重试。keys remove --json必须提供--force，以跳过交互式确认。login --json会返回用法错误，因为登录需要交互。--output只保存 Run 的 output 字段。写入成功后，stdout 包含完整 Run。文件写入失败时，stdout 为空，stderr 输出io_errorJSON 对象，并以1退出。JSON 模式不会向 stderr 打印文件状态提示。
run 和 runs get，FAILED 或 STOPPED 状态的 Run 仍会输出到 stdout；同时，命令向 stderr 写入 JSON 错误，并以退出码 1 结束。 Glasser 响应中的金额均为精确的十进制字符串，不使用浮点数。
退出码
对于
run 和 runs get，未使用 --wait 时，退出码 0 也可能表示 Run 仍处于 QUEUED 或 RUNNING 状态。即使数据提供商返回 HTTP 4xx 或 5xx，COMPLETED 状态的 Run 也以 0 退出；请检查 provider_response.http_status。 Run 状态与 charge_usd 必须分别检查。
runs stop 在停止请求被接受后以 0 退出，即使 Run 仍在运行。完整行为见停止 Run。
环境变量
供 Agent 使用
面向 Agent 的 glasser.ai/SKILL.md 包含本 CLI 的使用说明：适用场景、通过glasser login 认证的方法，以及付费操作的确认规则。将该文件提供给你的 Agent 即可。