Quick Start

One command scaffolds the GAIA React framework and automatically launches Claude Code for the rest of setup.

Prerequisites

• Node 22.19 or later. Check with node --version.
• Claude Code installed and reachable as claude.

pnpm is not required up front. When pnpm install runs (the default), create-gaia bootstraps pnpm via Corepack if missing, falling back to npm install -g pnpm. With --no-install, no bootstrap is attempted.

uv is required for the Serena MCP server. GAIA will install it for you during setup if you don’t already have it.

New GAIA project

For greenfield projects, run this command in the terminal:

npx create-gaia@latest my-app

my-app becomes the project directory. It must be empty or not yet exist; the scaffolder won’t write into a non-empty directory.

1. Downloads the latest GAIA release and installs it
2. Runs git init and creates a single chore: scaffold from GAIA <version> commit
3. Installs the packages
4. Launches Claude Code in the project directory and runs /gaia-init automatically

Follow along with the /gaia-init walkthrough.

Cloning an existing GAIA project

For existing projects (e.g. created by a teammate), after you clone the repo:

1. Run claude --dangerously-skip-permissions
2. Run /setup-cloned-gaia-project in Claude Code

Follow along with the /setup-cloned-gaia-project walkthrough.

Note: You can choose not to include --dangerously-skip-permissions. Leaving it out adds friction to the setup process, but it’s up to you.

Pinning to a specific version

Useful when you want a specific version of GAIA.

npx create-gaia@latest my-app --version v1.0.5