godogen README

The project's README from github.com/htdt/godogen. As one markdown file: README.md.

Godogen

Autonomous game development for Godot, Bevy, and Babylon.js with Claude Code and Codex.

Watch the video

Watch the demos · Prompts

Describe a game. The agent builds it, generates assets, runs the engine, and proves the result — as a live game you watch and steer, or as a recorded video when you're not there. It reads the situation and decides which, in the run.

This repo is not a game. It is the source for a generator that produces games: godogen -> game repo -> game. You publish into a fresh game repo — choosing engine and host-agent flavor — then the agent runs inside that repo and builds the actual game from a short engine guide.

Source layout

A published repo is intentionally thin: a runtime manifest, a one-page engine guide, and the asset-generation skill. The agent recreates everything else (project scaffold, capture tooling) from the guide.

Engine and host agent (Claude vs Codex) are publish-time render choices, not separate source trees.

What the agent does

Getting started

Prerequisites

Publish a game repo

Pick the engine and host agent:

./publish.sh --engine godot   --agent claude --out ~/my-game       # CLAUDE.md + .claude/skills/
./publish.sh --engine babylon --agent codex  --out ~/my-game       # AGENTS.md + .agents/skills/
./publish.sh --engine bevy    --agent claude --out ~/my-game

Pass --force to wipe existing contents at the target before re-publishing.

Running on a server

A full generation run can take hours, so it's convenient to offload it to a server — ideally a GPU instance, since engine rendering and video capture are much faster with hardware acceleration.

Changelog

See CHANGELOG.md.

Follow progress: @alex_erm

godogen (htdt/godogen)

webgl
Searching Database…

7.2K ·GitHub
What is this?Godogen is a generator that publishes thin starter repos for Godot, Bevy, or Babylon.js games, which an AI coding agent (Claude Code or Codex) then builds out autonomously from a prompt — writing code, generating assets, running the engine, and proving the result with a live view or a recorded clip.
Is this a game, or a tool that makes games?Neither a game nor a game engine — it is the source for a generator. Running godogen publishes a new repo (choosing engine and host agent), and the agent then builds the actual game inside that fresh repo.
How do I publish a game repo?Run publish.sh and pick the target engine (Godot, Bevy, or Babylon.js) and host agent (Claude or Codex); it renders the runtime manifest, engine guide, and asset-generation skill into a fresh repo. Pass --force to overwrite an existing target.
What do I need installed before running a generated repo?Godot 4 (.NET build) for Godot, Rust/Cargo for Bevy, or Node.js 22.12+ with npm and Chrome/Chromium (hardware WebGL2) for Babylon.js, plus Python 3 with pip and either Claude Code or Codex installed.
Is it tested to work on any OS?It's explicitly tested only on Ubuntu, Debian, and macOS; there's no mention of native Windows support. Full generation runs can also take hours, so long unattended sessions usually need a server with SSH kept alive via tmux or screen.
Who is this for, and does it need a beefy machine?It's for developers comfortable running agentic coding tools who want a hands-off or semi-steered way to prototype games; a GPU instance is recommended for long runs since engine rendering and video capture are much faster with hardware acceleration.
What API keys do I need to generate assets?GOOGLE_API_KEY for Gemini image generation, XAI_API_KEY for xAI Grok image/video generation, and TRIPO3D_API_KEY for Tripo3D 3D model generation and rigged animation.
How does the agent prove the game actually works?It judges the running game rather than a clean compile — either a live URL/engine session you can watch and steer, or an unattended run that ends in a 15-20 second recorded proof clip, so visible bugs drive the next fix.
What's different about each supported engine?Godot 4 projects use C#/.NET with build-time scene generation and Jolt physics, Bevy projects are Rust with code-first ECS scenes and offscreen capture, and Babylon.js projects are TypeScript/Vite browser games served at a live URL.
Can I watch the agent work in real time or just get a result later?Both: you can watch the live game and steer it at decision points, or leave the run unattended and get a short proof recording when it's done — the agent reads how you frame the task to decide which mode to use.
Creator
htdt
Size
0.6 MB
Stars
7.2K
Updated
CommitOct 16
Age
8mo
Commits · 90 Days