MiniGrove

MiniGrove Kit — Get started

One command plants a game.
Your agent grows it.

create-minigrove scaffolds a project that Claude Code or Codex already knows how to work in — the skills, workflows, and guardrails of the MiniGrove Kit, in place before you write a line of code.

Before you begin

What you need

  • Node.js 22+runs the scaffolder and the grove CLI
  • Gitevery kit workflow assumes version control
  • Claude Code or Codexinstall and sign in to one: Claude Code · Codex
quick check
node --versionv22 or newernpm --versioninstalled with Node.jsgit --versionversion control is ready

No Node.js yet? Install the latest LTS from the official Node.js download page. npm comes with Node.js, so you do not install it separately. Reopen your terminal afterwards, then run the first two checks again.

Install and sign in to only the agent you plan to use. Confirm it with claude --version or codex --version.

Building for Unity? You'll want Unity 6000.x. Art tools use Python 3.10+ and a usable image backend. Signed-in Codex can use its built-in image tool without an extra key; other providers may need one. Once you're set up, /mg-minigrove-doctor (Codex: $mg-minigrove-doctor) reports anything missing, with the exact fixes.

  1. Early access

    Get the kit

    The kit is in early access, so it isn't on npm yet — we send it to you directly. Interested in trying it out? Say hello, and the latest build lands in your inbox.

    Email [email protected]
    once it arrives
    npm install -g ~/Downloads/create-minigrove-0.3.1.tgzadds create-minigrove and grove to your PATH

    The filename carries the version you received. When a newer build lands later, run /mg-kit-update (Codex: $mg-kit-update) with the new file's path from inside your project — it upgrades the kit in place.

  2. In your terminal

    Create your project

    Pick the agent you build with. One command scaffolds the project. Keep this terminal open: if this machine is not signed in to MiniGrove yet, the account prompt appears before the command finishes.

    Claude Code project
    create-minigrove my-game
    Codex project
    create-minigrove --codex my-game

    The scaffold writes a .gitignore, runs git init, and makes the first commit for you (--no-git skips that). On desktop, click any command to select it.

  3. MiniGrove account · Optional

    Create your account as you scaffold

    In an interactive terminal, create-minigrove asks Register this project on MiniGrove now? Press Enter to accept the default Yes. Your browser opens automatically so you can create or use a MiniGrove account.

    New to MiniGrove? Choose Sign up, create your account, then open the verification email on this same computer. Complete the browser steps within five minutes and approve Grove CLI; the waiting scaffold returns and creates the shared project. If the terminal times out first, finish verifying — it keeps the project local and prints the recovery steps.
    Already have an account? Log in and approve Grove CLI. If this machine is already signed in, the scaffold skips the question and creates the shared project automatically.

    Prefer local-only? Answer No or pass --no-grove; nothing is sent. Before signing in, see what leaves your machine in the Privacy Policy and Terms of Service.

  4. Open your agent

    Let /mg-setup drive

    Once the scaffold and any MiniGrove sign-in are finished, open the new folder in Claude Code or Codex. The agent greets you and takes it from there: your builder profile, then the project itself.

    Claude Code app

    open my-game in the app, then type:

    /mg-setup
    Codex app

    open my-game in the app, then type:

    $mg-setup

    Prefer the CLI? Start the agent from the new project folder:

    CLI · Claude Code
    cd my-gameclaude

    then, inside the session:

    /mg-setup
    CLI · Codex
    cd my-gamecodex

    then, inside the session:

    $mg-setup
    Fresh concept? Positioning Office Hours sharpens the idea — and recommends an engine — before any engine project is scaffolded.
    Existing Unity project? Setup detects your Unity version, tests, and build targets before it writes any config.

Already mid-project?

Add the kit to an existing Unity project

Run the scaffold from your project root. It adds the kit alongside what's already there, leaves your git history alone, and refuses to overwrite kit-managed files unless you pass --force.

Claude Code app
create-minigrove --into .

then open the project in the app, and in the chat type:

/mg-setup
Codex app
create-minigrove --codex --into .

then open the project in the app, and in the chat type:

$mg-setup

Staying in the terminal? After the scaffold command, run claude or codex from the project root, then /mg-setup / $mg-setup.

Three useful commands

Remember one: mg-checkpoint

Describe most work to your agent in your own words. These commands are for three moments where a named workflow makes the handoff safer and the next step clearer.

Most important · Finish every work session Claude Code: /mg-checkpoint · Codex: $mg-checkpoint. It captures what changed, the decisions and lessons worth keeping, reviews the work, and leaves a clear handoff with next steps.
Before picking work back up Claude Code: /mg-sync · Codex: $mg-sync. It brings your branch up to date with the latest main and explains what changed around you.
When something is not ready Claude Code: /mg-minigrove-doctor · Codex: $mg-minigrove-doctor. It checks tools and credentials without exposing secret values, then gives you the exact fixes.

Ready for the first task

Now grow something worth gathering around.

Open the project in your agent, let mg-setup finish the introduction, then describe the first thing worth building. Or step back and see the full workflow your project just joined.

Start your first task See the workflow

Questions? [email protected]