whatisgithub

What is worldx-agent-forge?

huanglittleorange/worldx-agent-forge — explained in plain English

Analysis updated 2026-05-18

28TypeScriptAudience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

A Codex skill that turns a one-sentence description into a generated game world, artwork, and a running local simulation.

Mindmap

mindmap
  root((WorldX Agent Forge))
    What it does
      Generates world from one sentence
      Creates map and character art
      Runs local simulation
    Tech stack
      TypeScript
      OpenAI Codex
      WorldX engine
    Use cases
      Prototype a game world quickly
      Generate character art
      Run a local world simulation
    Audience
      Vibe coders
      Game hobbyists
    Setup
      No API key needed for generation
      Optional text model for simulation
      Bundles WorldX engine

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Describe a game world in one sentence and have Codex generate its map, characters, and a running simulation.

USE CASE 2

Prototype a game concept quickly without manually designing world rules or artwork.

USE CASE 3

Run a local browser-based simulation to see generated characters make decisions over time.

USE CASE 4

Experiment with AI world-building without needing any external API keys.

What is it built with?

TypeScriptOpenAI CodexWorldX

How does it compare?

huanglittleorange/worldx-agent-forgeaudemodo/audemodo-responsive-keepalivecahn91/gpt-repo-mcp
Stars282828
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencevibe coderdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires OpenAI Codex with the skill installed, an optional text model API key powers ongoing simulation.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

WorldX Agent Forge is a plugin for the OpenAI Codex command-line tool that lets you describe a game world in one sentence and have Codex generate the world settings, map image, character images, and a running local simulation automatically. It is written primarily in Chinese, with an English summary at the end of the README. The plugin is called a Skill in Codex's terminology. After installation, you mention the skill name in a Codex conversation along with a description of the world you want, and Codex handles the rest: designing the world rules and characters, generating map and character artwork using its built-in image generation, processing the images into the format the simulation engine expects, and starting a local web server at localhost:3200 where you can interact with the result. The simulation engine bundled inside this repository is an open-source project called WorldX, which provides the browser-based world viewer, a backend simulation service, and a system for tracking character states and events over time. WorldX Agent Forge packages WorldX directly into the repository so users do not need to download or configure it separately. No external API keys are required for world generation when using the recommended Codex Asset Mode, since Codex handles both the text design and image generation itself. If you want characters to continue making decisions and having conversations after the world loads, you can optionally configure a text model in the WorldX settings page to power the ongoing simulation. Installation involves cloning the repository into Codex's skills directory and restarting Codex. The repository is licensed under MIT, and it bundles WorldX under WorldX's own MIT license.

Copy-paste prompts

Prompt 1
Install WorldX Agent Forge as a Codex skill and generate a fantasy world for me.
Prompt 2
Explain how Codex's Asset Mode generates map and character images without extra API keys.
Prompt 3
Help me configure a text model in WorldX settings so characters keep making decisions over time.
Prompt 4
Walk me through what happens after I describe a world to the WorldX Agent Forge skill.

Frequently asked questions

What is worldx-agent-forge?

A Codex skill that turns a one-sentence description into a generated game world, artwork, and a running local simulation.

What language is worldx-agent-forge written in?

Mainly TypeScript. The stack also includes TypeScript, OpenAI Codex, WorldX.

What license does worldx-agent-forge use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is worldx-agent-forge to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is worldx-agent-forge for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.