玻璃机 CLI
搜索、检查和运行一个键的付费API端点——第一当事方
glasser 数据平面的客户端 (/v1) (中文(简体) ).
安装
curl -fsSL https://glasser.ai/install.sh | sh # no npm needed (Node >= 22)
# or, with npm:
npm install -g @glasser-ai/cli
重运行任一命令升级. 然后说: glasser login。 。 。 .
图标
glasser search ["<query>"] --use-case "<ask>" [--limit N] [--cursor C] # no query lists the catalog; --use-case is always required
# -q/--query takes the same value; --query=<q> for a leading dash
glasser inspect -p <provider> -e <endpoint> [--endpoint-version N]
glasser run -p <provider> -e <endpoint> [-i '<json>'|@file | -f <path>]
[--endpoint-version N] [--idempotency-key K]
[--wait] [--wait-timeout s] [-o file]
glasser runs list [--limit --cursor --status --provider --endpoint]
glasser runs get -r <runId> [--wait] [--wait-timeout s] [-o file]
glasser runs stop -r <runId>
glasser balance
glasser balance history [--limit --cursor --kind]
glasser keys add --label <l> --key <k> | list | activate --label <l>
| remove --label <l> [--force]
glasser skill install [--target <agent>]
全球: -j/--json, (中文(简体) ), --help, (中文(简体) ), --version。 。 。 .
登录
glasser login [--no-browser] ——浏览器流:终端打印 a
匹配代码,控制台 /cli/authorize 页面打开,点击一次批准,
和关键在本地商店(在工作空间喷出后贴上标签,
已启动)。 仅在页面上的代码与终端匹配时批准
然后打印它输入的工作空间——读取该行。 拒绝或
已过期审批出站1号出站 带有再运行提示. login --json 是使用错误 :
非交互路径正在计算控制台中的密钥 +
glasser keys add。 。 。 .
密钥
优先发言: GLASSER_API_KEY (已验证;一个错误的值是一个错误,它
永不悄悄倒回) > 活动存储密钥 > 指向错误
glasser keys add。 。 。 .
当地商店是 $XDG_CONFIG_HOME/glasser/keys.json (默认)
~/.config文件模式 0600。 标签是独特的;第一个密钥自动激活;
删除激活的密钥使其失效; keys remove 只碰这个
它不撤销密钥。 只有被蒙上面罩的标志gl_1bba****已经
曾经印刷.
运行语义
status是运行的周期;Response: HTTP n是供货商的判决.COMPLETED+ 键HTTP 404是正常结果(由NO RESULT收费) ,而不是错误.- 这个
Idempotency-Key在发送前打印为 stderr。 之后 模糊失败( 运输出错、 超时、,service_unavailable- 那个 API在回答503之前可能已经接受了一次运行 重放是读数,从不收费两次。 错误消息带有 确切的重试命令. --wait民意调查(0.5s-×2-上限10s)至终点站;--wait-timeout(默认300s)要求--wait。同步端点在一个中解答 来回旅行,从不投票.-o <file>写“运行”output操作 非正负输出。 人类模式在不重复保存的情况下打印运行摘要 体质;--json保持整个运行在 stdout。 失败和提供方错误依然存在 可见.- 钱田是精确的美元十进制字符串,印刷的逐字记录。 算起来 与小数算术,永不浮出.
流出代码
人模式: stdout上的数据; stderr上的进展,提示,提示和出错.
JSON 模式 (--json: stdout只携带原始的成功体;每一个错误——
包含使用错误 —— 是像 API 形状的 Stderr 上的单个 JSON 对象
信封( e){"error":{"code",...},"request_id"?}) (中文(简体) ). keys remove --json
需求 --force 因此,一个提示永远不会 破坏机器输出.
| 代码 | 含义 |
|---|---|
| 0 个 | 圆满. 完整运行( 任何提供者状态); 成功 runs stop。 。 。 . |
| 1个 | API 错误, 运输失败, --wait 暂停,或 run编号 :runs get 结束故障/停止. |
| 2个 | 用法:坏旗或输入 JSON,无效的嵌入值,没有配置密钥. |
| 130个 | 被打断了. |
设计说明
search匹配POST /v1/endpoints/search——CLI动词为API动词.--wait财务报告和审定财务报表--wait-timeout <seconds>是不同的旗帜.-f/--input-file <path>与-i(互为专有.- 每个
run带有一个“同上”的键——用同样的键重试是“a” 阅读,从来没有第二次指控.
发展
pnpm --filter @glasser-ai/cli dev -- search -q "web search" --use-case "find a web search API" # tsx, no build
pnpm --filter @glasser-ai/cli build # esbuild → dist/glasser.js
node apps/cli/dist/glasser.js --help
cd apps/cli && pnpm link --global # a PATH `glasser` shim
pnpm --filter @glasser-ai/cli test:p0 # unit
GLASSER_API_KEY=gl_… pnpm --filter @glasser-ai/cli test:integration # needs seeded :3101
信封 : GLASSER_API_BASE_URL (默认) https://api.glasser.ai, (中文(简体) ),
GLASSER_API_KEY, (中文(简体) ), XDG_CONFIG_HOME, (中文(简体) ), NO_COLOR (颜色在
框架的帮助和版本文本).