Appendix D — CLI Reference
All commands and flags.
Commands
Section titled “Commands”ai-rpg-engine run
Section titled “ai-rpg-engine run”Start a game session.
ai-rpg-engine run [--starter <name>] [--seed <number>]| Flag | Description |
|---|---|
--starter | Starter world to load (default: fantasy) |
--seed | Random seed for deterministic sessions |
ai-rpg-engine replay
Section titled “ai-rpg-engine replay”Replay a recorded session.
ai-rpg-engine replay [--file <path>] [--verbose]| Flag | Description |
|---|---|
--file | Path to action log file |
--verbose | Print all events during replay |
ai-rpg-engine inspect-save
Section titled “ai-rpg-engine inspect-save”Print a save file in readable format.
ai-rpg-engine inspect-save [--file <path>] [--section <name>]| Flag | Description |
|---|---|
--file | Path to save file |
--section | Filter to a specific section (entities, zones, modules) |
Development Commands
Section titled “Development Commands”npm run build
Section titled “npm run build”Build all packages.
npx tsc --buildnpm test
Section titled “npm test”Run the full test suite.
npx vitest runnpm run test:watch
Section titled “npm run test:watch”Run tests in watch mode during development.
npx vitest