A game-production baseline for your AI agent

Make your game.
Keep your bearings.

Give your coding agent a shared playbook for planning, building and checking your game. Keep the decisions, the context and the final say in your project.

Works alongside Codex, Claude, Cursor and compatible coding agents.

Hephaera’s shared robotic owl, in charcoal, steel and goldHephaera A little more direction. A lot less starting over.
Build with the engine you choose
Three.js · Babylon.js · Phaser · Unity · Unreal · Godot

WHAT IT IS

A shared playbook.
Right in your repository.

Hephaera lives in a .hephaera/ folder inside your game project. It gives your agent reusable instructions, specialist workflows and a place to keep project context between sessions.

You describe the result you want. Together, you work out a plan, use the right tools and check what actually happened. You still choose the engine, approve the work and review the result.

Take the short tour

FROM IDEA TO REVIEW

Start with a conversation.

You don’t need to memorize a list of commands to ask for useful work.

A first request might sound like this
“Help me make a small playable prototype. Start with movement, one enemy and a clear HUD. Show me a plan before changing files.”
Walk through your first session
  1. 01

    Talk it through

    Explain what the player should experience and what matters to you.

  2. 02

    Make a plan

    Choose a manageable scope, the right tools and a way to judge the result.

  3. 03

    Build and check

    Work through the change, with tests, playthroughs and evidence that fit the task.

  4. 04

    Review and decide

    Keep what works. Revise what doesn’t. Approve delivery when it’s ready.

THE WORK AROUND THE GAME

Give each part a clear path.

GET STARTED

One folder.
A better starting point.

Fork Hephaera first so your team controls its version and updates. From your game project’s root, add your fork as a submodule:

Full installation guide, including clone and Windows setup
Run in your game projectGit + Bash
git submodule add https://github.com/YOUR-ORG/Hephaera.git .hephaera
git submodule update --init --recursive --checkout -- .hephaera
bash .hephaera/commands/create-host-ai-scaffold.sh

Replace YOUR-ORG with your fork’s owner. Optional tools and local generation have their own setup steps.

TWO WAYS TO FIND YOUR WAY

Guides for doing.
Reference for the details.

Find your next step

Type a few words to find a guide.

Looking for a command or contract? Use the reference wiki