mcpField
R
remix-cli

remix-cli

github.com/farworld-labs開発45 回インストール
リポジトリ

remix-cli について

Remixのゲームと関連プロジェクトの作業をコマンドラインで管理するスキルです。認証、設定、アップロード、バージョン、公開準備状況、ショップアイテム、分析に対応し、自動処理向けのJSON出力も備えています。

主な機能

  1. 01認証と設定の管理
  2. 02ゲームとアセットの管理
  3. 03バージョンコードのアップロードと検証
  4. 04公開準備状況と分析
  5. 05ショップアイテムの管理
  6. 06自動処理向けJSON出力

活用シーン

  1. 01ゲームの作成とコードのアップロード
  2. 02ゲームアセットとバージョンの管理
  3. 03公開準備状況と分析データの確認
  4. 04エージェントのワークフローでのCLI出力解析

インストール

コマンドをコピーしてターミナルで実行します。

$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 は機械可読な出力を強制します。
  • TTY ではない stdout の場合、デフォルトで JSON が出力されます。
  • --quiet は人間向けのステータス出力を抑制し、JSON に適した出力を行います。

エージェントによる解析やシェルパイプラインでは、JSON モードを使用してください。

設定モデル

  • プロジェクト設定は、最も近い .remix-cli.json に格納されます。
  • 認証情報は ~/.config/remix/credentials.json に格納されます。
  • 従来の .remix-mcp.json も引き続き検出されますが、新しい CLI 設定ファイルは .remix-cli.json です。
  • CLI コマンドでは、REMIX_API_URL によって 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 がデバイスコードの表示後に中断された場合は、2 回目のデバイス認証フローを開始せず、remix login <deviceCode> で再開してください。
  • ユーザーが自分のゲーム一覧を明示的に求めた場合に限り、remix games list を使用してください。
  • 生のアップロードリクエストを手作業で組み立てるよりも、remix games versions code update --code-path ... を優先してください。
  • 本番環境以外の API を使用したローカル開発では、remix config set --api-url http://localhost:3003 を設定してください。

コメント

Markdown 対応