Commands

Complete reference for all gwen CLI commands.

Installation

Install the CLI globally to use the gwen command anywhere:

npm

npm install -g @gwenjs/cli

pnpm

pnpm add -g @gwenjs/cli

yarn

yarn global add @gwenjs/cli

Or run it directly without installing:

npx

npx @gwenjs/cli <command>

pnpm dlx

pnpm dlx @gwenjs/cli <command>

yarn dlx

yarn dlx @gwenjs/cli <command>

Global Options

Available on every command:

Option	Alias	Type	Description
--verbose	-v	boolean	Show detailed logs
--debug		boolean	Show debug information (very verbose)

All Commands

Command	Description
gwen init	Scaffold a new GWEN game project
gwen dev	Start development server with hot reload
gwen build	Build project for production
gwen prepare	Generate .gwen/ directory (tsconfig + types)
gwen preview	Preview the production build locally
gwen add	Install and register a GWEN module
gwen scaffold	Scaffold artefacts (plugin, module, package)
gwen lint	Lint source code with oxlint
gwen format	Format source code with oxfmt
gwen info	Show parsed gwen.config.ts as JSON
gwen doctor	Run project health checks