用途:Remix CLI 面向人工终端工作流,当任务涉及本地登录鉴权、配置管理、游戏创建、资源上传、代码上传或数据分析时,官方建议优先使用它,而不是手写 REST 请求。
主要能力: 鉴权与身份:remix login、remix whoami。 配置:remix config set|get|where。 健康检查:remix health get。 游戏:remix games list|get|create。 资源:remix games assets list|upload,remix games icon upload。 元数据:remix metadata categories list,remix games categories set。 版本:remix games versions list|get|code get|code update|thread get|status get|validate get。 上线准备度:remix games launch-readiness get。 分析:remix games analytics overview get、shop get、leaderboard get。 商店物品:remix games items list|create|update|delete。
必要用法:安装并登录可执行 curl -fsSL https://remix.gg/install.sh | bash 后运行 remix login,再用 remix whoami 确认身份。创建与上传游戏示例:remix games create --name "My Game"、remix games icon upload ./icon.png、remix games versions code update --code-path ./game.html、remix games versions validate get。对非生产 API 做本地开发时,用 remix config set --api-url http://localhost:3003。
输出模式:--json 强制机器可读输出;非 TTY 的 stdout 默认输出 JSON;--quiet 抑制仅面向人的状态信息并隐含 JSON 友好输出,适合智能体解析与 shell 管道。
配置模型:项目配置位于最近的 .remix-cli.json;凭据位于 ~/.config/remix/credentials.json;旧版 .remix-mcp.json 仍可被发现,但新配置为 .remix-cli.json;REMIX_API_URL 可覆盖 CLI 命令的 API 基础地址。运行时优先级为:显式标志、环境变量、已存配置与凭据、默认值。
限制与注意事项:使用已有 .remix-cli.json 中的 gameId 和 versionId;手动排查鉴权问题前先运行 remix whoami;若 remix login 打印设备码后中断,应使用 remix login <deviceCode> 继续,而不是重新发起第二次设备鉴权流程;仅在用户明确需要游戏列表时使用 remix games list;优先使用 remix games versions code update --code-path ...,而不是自行构造原始上传请求。资料未提供平台收费、价格与具体效果等信息。