Open GameStudio is a Node/TypeScript CLI package for creating and managing local, agent-assisted game projects. It provides project scaffolding, engine-aware configuration, base agent prompts, reusable templates, bounded prompt packets, and validation gates that keep generated project artifacts predictable.

The package is an agent workflow layer for game making. It does not host a service, execute assistants directly, or require a specific model provider. The current CLI prepares the project structure and prompt context that Codex or another agent can use from your own environment.

Why This Exists

Open GameStudio started as a port motivated by a simple need: make the game-studio workflow open, portable, local-first, scriptable, and usable outside a single assistant environment.

Claude Game Studio deserves real kudos for proving that role-based game-development workflows can be practical and useful. Open GameStudio is inspired by that idea, but it is an independent implementation with different priorities:

CLI and package first, with deterministic npm scripts for local development.
Provider and model agnostic, with no direct Claude, Codex, or assistant lock-in.
Generated game projects live under projects/<slug>/.
Engine configs, templates, and base agents are package assets.
Validation is explicit and hard-failing instead of advisory.
Prompt packets are prepared for external agents instead of spawning a provider process.
Direct Codex execution, telemetry, planner/next, ownership enforcement, changed-file tracking, and parallel orchestration are future-only.

The goal is not to clone another tool. The goal is to make the workflow contract inspectable, portable, and easy to run in normal developer tooling.

Requirements

Node.js 20 or newer.
npm.

Install

For package use after installation or linking:

npm exec open-gamestudio -- --help
npm exec open-gamestudio -- templates list

For local development from this repository, use the npm scripts. They build first and then exercise the built CLI through node dist/cli.js:

npm run init -- --name "My Game" --engine godot --mode prototype --non-interactive
npm run manage -- --project projects/my-game
npm run templates -- list
npm run validate -- --project projects/my-game

Quick Start

Create a project:

npm run init -- --name "My Game" --engine godot --mode prototype --non-interactive --concept "A compact puzzle game about routing trains"

Inspect project status:

npm run manage -- --project projects/my-game

List templates:

npm run templates -- list

Show a template:

npm run templates -- show gdd

Validate the repository or a generated project:

npm run validate
npm run validate -- --project projects/my-game

Prepare a bounded prompt packet for an agent:

npm run build --silent
node dist/cli.js run market_analyst --project projects/my-game --task "Create the initial market overview." --dry-run

The run command prepares context and output paths. In this build, you execute Codex or another agent separately and point it at the generated prompt packet.

CLI Commands

init / new: create a project under projects/<slug>/.
status: print project phase, status, engine, and next validation command.
resume: print a read-only continuation summary.
freeze: mark a project as frozen.
validate: run repository or project validation and exit nonzero on failure.
templates list: list packaged template IDs.
templates show <template-id>: print a packaged template.
run <agent>: prepare one bounded prompt packet for a project agent.

Project Layout

Repository assets:

src/: TypeScript CLI implementation.
agents/base/: base role prompts packaged with the CLI.
templates/: reusable document and setup templates.
engine_configs/: engine overlays for Godot, Unity, and Unreal.
docs/: setup, migration, validation, and example notes.
tests/: Vitest coverage for project workflow, templates, agents, runner prompts, validation, and engine behavior.

Generated project artifacts:

projects/<slug>/: the project root created by init.
project.gamestudio.json: project metadata and workflow state.
AGENTS.md: generated project instructions owned by src/agents.ts.
documentation/: generated game-design and workflow documents.
source/project-<slug>/: engine project location contract.
.gamestudio/runs/: prepared prompt packets and run metadata.

Development

Use the repository scripts:

npm run build
npm run typecheck
npm run test
npm run validate

This project uses ESM TypeScript with module and moduleResolution set to NodeNext. Relative TypeScript imports include the emitted .js specifier.

License

Open GameStudio is released under the MIT License. See LICENSE.