@remix-gg/cli

The official CLI for Remix.

Built for humans, AI Agents, and CI/CD pipelines.

▄▄▄▄▄▄▄    ▄▄▄▄▄▄▄ ▄▄▄      ▄▄▄ ▄▄▄▄▄ ▄▄▄   ▄▄▄ 
███▀▀███▄ ███▀▀▀▀▀ ████▄  ▄████  ███  ████▄████ 
███▄▄███▀ ███▄▄    ███▀████▀███  ███   ▀█████▀  
███▀▀██▄  ███      ███  ▀▀  ███  ███  ▄███████▄ 
███  ▀███ ▀███████ ███      ███ ▄███▄ ███▀ ▀███ 

Install

curl -fsSL https://remix.gg/install.sh | bash

Or use npm directly:

npm install -g @remix-gg/cli

Quick Start

Authenticate:

remix login

Inspect the active auth/config context:

remix whoami
remix whoami --json

Create or update a game:

remix games create --name "My Game"
remix games icon upload ./icon.png
remix games versions code update --code-path ./game.html

Manage shop items:

remix games items list
remix games items create --name "Extra Life" --bits-cost 50
remix games items create --name "Premium Skin" --item-type ONE_TIME --bits-cost 100
remix games items update --item-id item_xxx --bits-cost 75
remix games items delete --item-id item_xxx

Output

The CLI is human-readable in interactive terminals and machine-readable for agents:

• --json forces JSON output
• non-TTY stdout defaults to JSON output
• --quiet suppresses human-only status output and implies --json

Examples:

remix whoami --json
remix games list --json
remix games create --name "My Game" | jq

Auth And Config

Runtime config precedence is:

1. explicit command flags
2. environment variables
3. stored config/credentials
4. defaults

Supported environment variables:

• REMIX_API_KEY
• REMIX_API_URL

Stored files:

• global credentials: ~/.config/remix/credentials.json
• project config: nearest .remix-cli.json

For local development:

remix config set --api-url http://localhost:3003
remix login

Commands

• remix login
• remix whoami
• remix config set
• remix config get
• remix config where
• remix health get
• remix games list
• remix games get
• remix games create
• remix games assets list
• remix games assets upload
• remix games icon upload
• remix games categories set
• remix games launch-readiness get
• remix games versions list
• remix games versions get
• remix games versions code get
• remix games versions code update
• remix games versions thread get
• remix games versions status get
• remix games versions validate get
• remix games items list
• remix games items create
• remix games items update
• remix games items delete
• remix metadata categories list

Use built-in help for command details:

remix --help
remix login --help
remix games assets upload --help

Development

bun run build
bun run test
remix list-tools
remix games assets upload ./hero.png hero-image
remix games versions code update --code-path ./game.html