← Back to tutorials
Beginner~3 min

Have your AI CLI clone & launch ForgeaX

The most AI-native install: don't type the commands yourself — hand the repo to your coding-CLI agent and let it clone, install, launch, and report back the local URL.

✅ Open source (Apache-2.0). The flow below works with any AI coding CLI.

What you need

  • An AI coding CLI that can run shell commands — e.g. Claude Code, Codex, Cursor, or ForgeaX's own forgeax CLI;
  • git and Bun (the project runtime) installed;
  • an AI model API key (for Forge inside the studio).

One instruction to your CLI

Open your CLI in an empty folder and give it this:

Clone https://github.com/ForgeaX-Games/forgeax-studio
(with --recurse-submodules), cd into it,
run the install script to set up dependencies,
then run the start script to launch it,
and tell me the local URL I can open.

The CLI runs the clone / install / launch steps itself, asking you for anything it needs along the way (such as the API key). When it's done you get a local URL — open it in the browser and you're in the studio.

Manual equivalent (optional)

If you'd rather do it yourself, the equivalent is roughly:

git clone --recurse-submodules \
  https://github.com/ForgeaX-Games/forgeax-studio
cd forgeax-studio
bun fx setup     # install deps (+ add API key)
bun fx start     # launch the studio

These bun fx commands are cross-platform — the same on macOS, Linux and Windows, with no Git-Bash needed on Windows. Then open the local URL it prints.

Next, head to Quick start and tell Forge your first game.

Why is this the smoothest install? Because ForgeaX is built for AI in the first place — even "set itself up" is something we're happy to hand to an agent.

Next: your first game →