@caisual/cli

Create, test and publish browser games on Caisual, a free home for small browser games with multiplayer built in.

npx @caisual/cli init my-game
cd my-game
npx @caisual/cli dev
export CAISUAL_KEY='ck_...'
npx @caisual/cli publish

A game is a folder with caisual.json, client/index.html and, for rooms, server.js. Every publish creates a new immutable version behind one permanent address, caisual.com/g/<id>.

Commands

caisual init [--multiplayer | --arcade] [folder]
caisual dev [folder] [--port 8790] [--day YYYY-MM-DD] [--latency ms [--jitter ms] [--loss percent]]
caisual check [folder] [--json]
caisual publish [folder]
caisual versions [folder|id]
caisual rollback [folder|id] --to <n>
caisual unlist [folder|id]
caisual relist [folder|id]
caisual delete [folder|id] --yes
caisual skill

dev runs the game locally with the production handshake, several guests and network simulation. check runs every local validation used by publish without a key. skill writes the publishing guide, the kit reference and the index of the guides into .claude/skills/caisual/SKILL.md, so a coding agent reads the rules before it starts; init does the same in the new folder.

Documentation

• Publishing guide: the folder, the manifest, the limits and every command.
• Kit reference: the API the game calls, from @caisual/kit.
• Guides and llms.txt for coding agents.

Requires Node.js 20 or newer. Publishing is free; games run on caisual.com.