VibeGame AI Agent

<div align="center"> <img src="assets/teaser.webp" alt="VibeGame system teaser" width="780"> <p> <img src="https://img.shields.io/badge/Python-%E2%89%A53.12-3776AB?logo=python&logoColor=white" alt="Python 3.12+"> <img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="Apache License 2.0"> <a href="https://www.anthropic.com/claude-code"><img src="https://img.shields.io/badge/Claude_Code-supported-D97757" alt="Claude Code supported"></a> <a href="https://github.com/openai/codex"><img src="https://img.shields.io/badge/Codex-supported-111111" alt="Codex supported"></a> <a href="https://phaser.io"><img src="https://img.shields.io/badge/Engine-Phaser-6456e0" alt="Phaser"></a> </p> <p> <a href="https://vibegame.tettet.org"><strong>Project Page</strong></a> &nbsp;·&nbsp; <a href="https://vibegame.tettet.org/#demos"><strong>Watch Demos</strong></a> &nbsp;·&nbsp; <a href="./technical_report.pdf"><strong>Technical Report</strong></a> &nbsp;·&nbsp; <a href="https://discord.gg/Ec6d9wx8sU"><strong>Discord</strong></a> &nbsp;·&nbsp; <a href="assets/wechat-group.png"><strong>WeChat Group</strong></a> </p> <p><strong>VibeGame: Vibe Your Dream Game</strong></p> </div>

News

• [2026.08] 🚀 We release VibeGame: Prompt-to-Game Development with AI-Native Engine and Self-Evolving Adversarial Agent Team! Check our Project Page and Technical Report

Demos

Watch the demos and explore more project details on the Project Page.

<table> <tr> <td width="33%" align="center" valign="top"><a href="https://vibegame.tettet.org/#demos"><img src="assets/demo/page/thumbs/civilization.jpg" alt="Civilization demo" width="100%"></a><br><strong>Civilization prototype</strong></td> <td width="33%" align="center" valign="top"><a href="https://vibegame.tettet.org/#demos"><img src="assets/demo/page/thumbs/hk.webp" alt="Hollow Knight demo" width="100%"></a><br><strong>Hollow Knight boss slice</strong></td> <td width="33%" align="center" valign="top"><a href="https://vibegame.tettet.org/#demos"><img src="assets/demo/page/thumbs/kof.webp" alt="KOF demo" width="100%"></a><br><strong>Arcade fighter</strong></td> </tr> <tr> <td width="33%" align="center" valign="top"><a href="https://vibegame.tettet.org/#demos"><img src="assets/demo/page/thumbs/rog.webp" alt="Roguelike demo" width="100%"></a><br><strong>Dungeon roguelike</strong></td> <td width="33%" align="center" valign="top"><a href="https://vibegame.tettet.org/#demos"><img src="assets/demo/page/thumbs/intro.webp" alt="VibeGame intro" width="100%"></a><br><strong>VibeGame Intro</strong></td> <td width="33%" align="center" valign="top"><a href="https://vibegame.tettet.org/#demos"><img src="assets/demo/page/thumbs/fruit_ninja.webp" alt="Fruit Ninja demo" width="100%"></a><br><strong>Fruit Ninja</strong></td> </tr> <tr> <td width="33%" align="center" valign="top"><a href="https://vibegame.tettet.org/#demos"><img src="assets/demo/page/thumbs/parkour_dash.webp" alt="Aniya demo" width="100%"></a><br><strong>Aniya Parkour</strong></td> <td width="33%" align="center" valign="top"><a href="https://vibegame.tettet.org/#demos"><img src="assets/demo/page/thumbs/sekiro.webp" alt="Sekiro demo" width="100%"></a><br><strong>Pixel Sekiro</strong></td> <td width="33%" align="center" valign="top"><a href="https://vibegame.tettet.org/#demos"><img src="assets/demo/page/thumbs/werewolf.jpg" alt="AI Werewolf demo" width="100%"></a><br><strong>AI Werewolf party game</strong></td> </tr> </table>

Installation

Prerequisites:

• Python 3.12 or newer.
• uv.
• tmux.
• At least one supported agent CLI: Claude Code or Codex.

Node.js and npm are not required for the standard VibeGame setup.

First-time Claude Code users: VibeGame launches agents with claude --dangerously-skip-permissions. If you have never used this flag before, run it once in a terminal and accept the confirmation prompt — the first-run consent screen cannot be completed inside VibeGame's managed session, and agent startup will fail without it.

Codex users: after setup.sh, run vibegame setup codex-hooks once, then open Codex, enter /hooks, and trust the newly added VibeGame hooks. The command writes ~/.codex/hooks.json; the trust step is what actually enables them. Until both are done Codex agents still run, but they never register: the Dashboard stays empty and startup keeps waiting for a session that never appears.

git clone https://github.com/tettethu/VibeGame
cd VibeGame

Tell your agent (Claude Code or Codex):

Read and follow the instructions in @docs/SETUP.md to set up this project for me.

Or set it up manually:

./setup.sh

setup.sh links the installed vibegame command to this checkout so the CLI can use the bundled engine, templates, and Dashboard. Keep the checkout available; pulling updates changes the installed CLI without reinstalling it.

Quick Start

mkdir my-game && cd my-game
vibegame init
vibegame start

Or start an existing project from another directory:

vibegame start --project ./my-game "Continue polishing the boss fight"

Use VibeGame's standard build workflow for an end-to-end game development goal:

/vibegame-build Build a compact roguelike dungeon with one boss encounter

Run or close the game directly:

vibegame run --port auto
vibegame close

Godot (experimental)

A Godot 4 companion sits beside the Phaser workflow. It has its own scaffold, runtime bridge and checks, and vibegame play works against it unchanged:

mkdir my-godot-game && cd my-godot-game
vibegame godot init --name "My Godot Game"
vibegame godot check
vibegame godot run --port auto
vibegame play screenshot -o /tmp/shot.png
vibegame close

The multi-agent build workflow and art pipeline are still Phaser-only. See docs/GODOT.md for the runtime protocol and current limits.

VibeGame Dashboard

We provide a web dashboard for interacting more freely with the agent team and manually editing game properties.

The Objects editor detects conflicting file changes and keeps your local edits for recovery. See editing objects while agents are working.

<table> <tr> <td width="50%" align="center"><img src="assets/dash_chat.webp" alt="VibeGame Dashboard Chat"><br><strong>Chat</strong><br>_{Chat with your agents to start building}</td> <td width="50%" align="center"><img src="assets/dash_asset.webp" alt="VibeGame Dashboard Assets"><br><strong>Assets</strong><br>_{Preview animations and adjust sprite bounds}</td> </tr> <tr> <td width="50%" align="center"><img src="assets/dash_objects.webp" alt="VibeGame Dashboard Objects"><br><strong>Objects</strong><br>_{Configure character animations and properties}</td> <td width="50%" align="center"><img src="assets/dash_play.webp" alt="VibeGame Dashboard Play"><br><strong>Play</strong><br>_{Play the game you are building}</td> </tr> </table>

Roadmap

• Release the VibeGame technical report
• Open-source the Phaser-based VibeGame implementation
• Add Godot support (experimental CLI: vibegame godot)
• Integrate Godot with the multi-agent build workflow
• Add Unity support
• Expand VibeGame from 2D to end-to-end 3D game creation

Acknowledgments

We are inspired by the broader community exploring AI agents for game creation, game development, and gameplay. We thank the teams behind GameDevBench, OpenGame, GameCraft-Bench, and other open-source projects for advancing this field and sharing their work with the community.

• Claude Code and OpenAI Codex - agent runtimes supported by VibeGame.
• Phaser - the web game framework beneath VibeGame's 2D engine.
• Trellis - inspiration for the design of VibeGame's development harness.
• agent-sprite-forge - inspiration for VibeGame's sprite-generation prompt design.

License

VibeGame is released under the Apache License 2.0.

Commercial Deployment Notification

If you deploy VibeGame or a modified version as part of a commercial product or service, we kindly ask you to notify us at kiyotakali075@gmail.com.

Please include the name of your organization, the product or service name, and a brief description of how VibeGame is being used. No confidential information is required.

This notification is requested for project tracking and community outreach purposes only. It does not require approval, impose a license fee, or modify any rights granted under the Apache License 2.0.