@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 upload <slug> <dir>

Upload a game build directory to Puzzmo.

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.

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.