CLI 安装与命令参考
按用途查当前版本命令，用真实返回值串联后续调用。
安装入口与版本确认
本页命令和参数以正式版 CLI 0.5.2 为准（2026-10-22 核对）。完整安装和认证在 安装与调用LoomLoom。
npx @cogfoundry/loomloom@latest install --agent codex --yes
loomloom --version
上例一次安装 Codex 的 CLI 和通用 Skill；只装 CLI 可用 npm install -g @cogfoundry/loomloom。完整 Skill 目录安装和其他 Agent 的方式见安装页。
平台、登录、配置与诊断
| 用途 | 必要信息 | 最小示例 | 返回或效果 |
|---|---|---|---|
| 环境诊断 | 已配置目标平台 | loomloom doctor --output json |
健康及认证状态 |
| 浏览器登录 | 对应平台 | loomloom login --help |
当前登录选项 |
| 服务配置 | 目标地址 | loomloom server --help |
配置方式 |
参数按当前帮助检查，避免把凭证写进公开日志。
模板与模型查询
| 用途 | 必要信息 | 最小示例 | 返回 |
|---|---|---|---|
| 官方输入结构 | 模板标识 | loomloom template schema text-v1 |
当前字段 |
| 私有模板管理 | 按子命令选择对象 | loomloom template-spec --help |
创建、版本和执行入口 |
| 能力解析 | 输入与输出形态 | loomloom capability resolve --input text --output-modality text --output json |
当前匹配能力 |
| 模型查询 | 步骤能力类型 | loomloom model list --step-type text-generate --output json |
可编写模型集合 |
市场、运行与文件
| 用途 | 必要信息 | 最小示例 | 返回 |
|---|---|---|---|
| 市场详情 | 实际 Listing 标识 | loomloom market show <listing-id> |
公开说明与输入 |
| 工作簿入口 | 对象和当前字段 | loomloom market workbook --help |
下载、报价、运行方式 |
| 运行状态 | 运行标识 | loomloom run get <run-id> |
当前状态 |
| 结果工作簿 | 运行标识 | loomloom run result-workbook <run-id> |
结果工作簿 |
| 生成文件 | 按文件入口返回信息 | loomloom artifact --help |
文件查询及保存方式 |
发布、审核、收益与本地 Skill
| 用途 | 必要信息 | 最小示例 | 返回或效果 |
|---|---|---|---|
| 发布管理 | Listing 与候选版本 | loomloom listing --help |
发布和管理入口 |
| 审核记录 | 相应审核对象 | loomloom creator review --help |
查询与处理入口 |
| 收益查询 | 按来源筛选 | loomloom creator earnings --help |
收益查询方式 |
| 交易查询 | 当前账号及过滤项 | loomloom creator transactions --help |
明细查询方式 |
| 买家订阅 | 当前可售产品 | loomloom subscription --help |
查询、购买和续订入口 |
| 作者组合包 | 作者产品 | loomloom creator bundle --help |
组合包管理入口 |
| 本地包与安装 | 对象和当前 Agent 的 Skill 根目录 | loomloom skill package --help |
包管理和安装入口 |
当前 SkillApp 包安装入口：
loomloom skill package install market <listing-id> --skill-root <current-agent-skill-root>
loomloom skill package install official <template-slug> --skill-root <current-agent-skill-root>
这会安装服务提供的 ZIP 包；旧 skill install market / template-spec 是生成调用包装的兼容路线，不能把两者的参数或卸载方法混用。
需要完整调用链时读 程序化执行，不要把帮助查询当成已经执行修改。
通用参数、帮助与标识传递
--output json 用于结构化输出，--server 指定服务，--timeout 指定请求超时。
loomloom --help
loomloom <命令组> --help
从返回结果保存模板、版本、输入、运行和请求标识。不同对象的标识不能互换；新任务用新请求标识，模糊失败的同请求重试见 程序化执行。