@puzzmo/cli

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

Install

npm install -g @puzzmo/cli

Commands

puzzmo login <token>

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

puzzmo login pzt-your-token-here

puzzmo games upload <dir>

Upload a game build directory to Puzzmo. The game slug is read from puzzmo.json in the build directory.

puzzmo games upload dist/

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

puzzmo games validate [dir]

Validate every puzzmo.json under dir (defaults to the current directory) against the schema, without uploading anything.

puzzmo games validate

The older puzzmo upload and puzzmo validate (without games) still work as aliases, but the puzzmo games … forms are preferred.

puzzmo game create [token]

Interactive wizard to create a new Puzzmo game project.

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:

{
  "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

yarn create puzzmo game

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