mcpField
R
remix-cli

remix-cli

github.com/farworld-labs开发45 次安装
代码仓库

关于 remix-cli

用于通过命令行管理 Remix 游戏及相关项目流程的 Skill。涵盖身份验证、配置、上传、版本、上线准备度、商店物品和分析，并支持 JSON 输出以供自动化处理。

主要功能

  1. 01身份验证与配置管理
  2. 02游戏和资源管理
  3. 03版本代码上传与验证
  4. 04上线准备度与数据分析
  5. 05商店物品管理
  6. 06面向自动化的 JSON 输出

适用场景

  1. 01创建游戏并上传代码
  2. 02管理游戏资源和版本
  3. 03查看上线准备度与分析数据
  4. 04在 Agent 工作流中解析命令行输出

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/farworld-labs/remix-skills --skill remix-cli

安装后在 Claude Code 中输入/remix-cli确认已加载。

附带文件agents/openai.yaml

详细介绍

Remix Cli

概述

对于面向用户的终端工作流，请使用 remix CLI。在处理本地身份验证、配置管理、游戏创建、资源上传、代码上传或分析检查时，优先使用它，而不是手写 REST 请求。

快速开始

安装并进行身份验证：

curl -fsSL https://remix.gg/install.sh | bash
remix login
remix whoami
remix login <deviceCode>

创建并上传游戏：

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

输出模式

  • --json 强制输出机器可读的数据。
  • stdout 不是 TTY 时，默认输出 JSON。
  • --quiet 会抑制仅供用户查看的状态输出，并启用适合 JSON 的输出模式。

使用 JSON 模式进行 Agent 解析和 Shell 管道操作。

配置模型

  • 项目配置位于最近的 .remix-cli.json 中。
  • 凭据位于 ~/.config/remix/credentials.json 中。
  • 仍可发现旧版 .remix-mcp.json，但新的 CLI 配置文件是 .remix-cli.json。
  • REMIX_API_URL 会覆盖 CLI 命令使用的 API 基础 URL。
  • 运行时优先级如下：
    1. 显式标志
    2. 环境变量
    3. 已存储的配置和凭据
    4. 默认值

实用的检查命令：

remix config get
remix config where
remix whoami --json

可用命令

  • 身份验证：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、remix games analytics shop get、remix games analytics leaderboard get
  • 商店物品：remix games items list|create|update|delete

使用注意事项

  • 如果 .remix-cli.json 中已有 gameId 和 versionId，请重复使用。
  • 手动排查身份验证问题前，先运行 remix whoami。
  • 如果 remix login 打印设备码后被中断，请使用 remix login <deviceCode> 继续，而不是启动第二次设备身份验证流程。
  • 只有当用户明确要求查看其游戏列表时，才使用 remix games list。
  • 与其手动构造原始上传请求，不如使用 remix games versions code update --code-path ...。
  • 在非生产 API 上进行本地开发时，请设置 remix config set --api-url http://localhost:3003。

评论

支持 Markdown