open-index/open-npm huggingface dataset:
npm package: @remix-gg/cli
Description: Typed CLI command layer for Remix.gg agent services
Latest version: 0.9.0

# @remix-gg/cli

The official CLI for [Remix](https://remix.gg).

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

```
▄▄▄▄▄▄▄    ▄▄▄▄▄▄▄ ▄▄▄      ▄▄▄ ▄▄▄▄▄ ▄▄▄   ▄▄▄ 
███▀▀███▄ ███▀▀▀▀▀ ████▄  ▄████  ███  ████▄████ 
███▄▄███▀ ███▄▄    ███▀████▀███  ███   ▀█████▀  
███▀▀██▄  ███      ███  ▀▀  ███  ███  ▄███████▄ 
███  ▀███ ▀███████ ███      ███ ▄███▄ ███▀ ▀███ 
```

## Install

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

Or use npm directly:

```sh
npm install -g @remix-gg/cli
```

## Quick Start

Authenticate:

```sh
remix login
```

Inspect the active auth/config context:

```sh
remix whoami
remix whoami --json
```

Create or update a game:

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

Manage shop items:

```sh
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:

```sh
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:

```sh
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:

```sh
remix --help
remix login --help
remix games assets upload --help
```

## Development

```sh
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
```