open-index/open-npm huggingface dataset:
npm package: @puzzmo/cli
Description: Command-line tool for Puzzmo game developers. Authenticate, upload game builds, and create new game projects.
Latest version: 1.0.27

# @puzzmo/cli

Command-line tool for Puzzmo game developers. Authenticate, upload game builds, and create new game projects.

## Install

```bash
npm install -g @puzzmo/cli
```

## Commands

### `puzzmo login <token>`

Save a CLI auth token. Generate one from studio.puzzmo.com.

```bash
puzzmo login pzt-your-token-here
```

### `puzzmo upload <slug> <dir>`

Upload a game build directory to Puzzmo.

```bash
puzzmo upload my-game dist/
```

The command collects all files in the directory, computes a SHA from git (or file contents), and uploads them in batches.

### `puzzmo game create [token]`

Interactive wizard to create a new Puzzmo game project.

```bash
puzzmo game create --name my-game --url https://example.com/game/
```

Options:

| Option            | Description                                               |
| ----------------- | --------------------------------------------------------- |
| `[token]`         | Optional access token (runs `puzzmo login` automatically) |
| `--name <name>`   | Game name                                                 |
| `--url <url>`     | Source URL to import                                      |
| `--agent <agent>` | LLM agent: `claude`, `codex`, `gemini`, `none`            |

The wizard:

1. Downloads the source HTML page and assets
2. Detects installed LLM coding agents
3. Installs migration skills via the Vercel skills ecosystem
4. Runs each skill through the selected agent with build verification
5. Commits after each successful step

## Configuration

Config is stored in `~/.puzzmo/config.json`:

```json
{
  "token": "pzt-...",
  "apiURL": "https://api.puzzmo.com"
}
```

The token can also be set via the `PUZZMO_TOKEN` environment variable, and the API URL via `PUZZMO_API_URL`.

## Also available via

```bash
yarn create puzzmo game
```

This uses the `create-puzzmo` package which forwards to `puzzmo game create`.