@boozybats/genex

CLI for the Genex game-engine editor. Scaffolds a project folder, syncs your local TypeScript scripts to a shared server, and opens the editor in your browser.

Quick start

Start a new project:

npx @boozybats/genex create ./my-game

That command:

1. Creates a project on the hosted Genex server.
2. Writes gameDefinition.json, scripts/, engine-types.d.ts, tsconfig.json and a starter .claude/skills/ reference dump into ./my-game.
3. Opens the editor at https://genex-pi.vercel.app/?projectId=....
4. Watches the folder — every save in your IDE hot-reloads in the editor; every edit in the editor is mirrored back to disk.

Press Ctrl+C to stop watching.

Continue an existing project

Re-attach to a project you've already scaffolded:

npx @boozybats/genex edit ./my-game

This requires ./my-game/.genex.json to already exist (created by the first genex create). It re-attaches to the same server-side project, opens the editor, and starts watching. Running genex create in the same folder also re-attaches, so the two commands are interchangeable when the project already exists — edit simply errors out cleanly if there's nothing to attach to.

Install globally (optional)

npm install -g @boozybats/genex
genex create ./my-game

Self-hosting

If you run your own Genex server + editor, point the CLI at them:

genex create ./my-game \
  --server https://my-server.example.com \
  --editor https://my-editor.example.com

Or via env vars:

export GENEX_SERVER=https://my-server.example.com
export GENEX_EDITOR=https://my-editor.example.com
genex create ./my-game

Requirements

• Node.js ≥ 18.17
• A modern browser

License

MIT