### Initialize GAIA Setup

Source: https://docs.heygaia.io/self-hosting/cli-setup

Commands to start the interactive setup wizard or clone a specific branch.

```bash
# Run the setup wizard
gaia init

# Clone a specific branch
gaia init --branch develop
```

--------------------------------

### Initialize GAIA Instance

Source: https://docs.heygaia.io/cli/commands

Use `gaia init` for a complete first-time setup of a GAIA instance. This command guides you through prerequisites, port checks, repository setup, environment configuration, and project setup.

```bash
gaia init
```

--------------------------------

### Install GAIA CLI with bun

Source: https://docs.heygaia.io/cli/installation

Install the GAIA CLI globally using bun. Ensure Node.js 20+ is installed.

```bash
bun add -g @heygaia/cli
```

--------------------------------

### Form Field with Validation

Source: https://docs.heygaia.io/design-system

This example demonstrates a typical form field setup using `FormField`, `FormItem`, `FormControl`, and `FormMessage` for input management and displaying validation errors.

```tsx
<FormField
  control={form.control}
  name="fieldName"
  render={({ field }) => (
    <FormItem>
      <FormLabel>Label</FormLabel>
      <FormControl>
        <Input placeholder="..." {...field} />
      </FormControl>
      <FormMessage />  {/* auto-shows error */}
    </FormItem>
  )}
/>
```

--------------------------------

### Start Development Server

Source: https://docs.heygaia.io/configuration/environment-variables

Run this command to start the development server after configuring your environment variables.

```bash
mise dev 
```

--------------------------------

### CLI Auto-Discovery for Environment Variables

Source: https://docs.heygaia.io/configuration/environment-variables

Use the GAIA CLI for interactive setup and auto-discovery of environment variables. This process parses Python settings, scans example files, prompts for missing values, and validates the configuration.

```bash
# Interactive setup with auto-discovery
gaia init

# Or run setup separately
gaia setup
```

--------------------------------

### Preview Docs Locally

Source: https://docs.heygaia.io/CLAUDE

Run these commands from the 'docs/' directory to preview the documentation site locally. Ensure Mintlify CLI is installed globally.

```bash
# Preview docs locally (run from the docs/ directory)
nx dev docs
# or directly:
cd docs && mintlify dev

# Mintlify CLI must be installed: npm install -g mintlify
```

--------------------------------

### Initialize and Run GAIA

Source: https://docs.heygaia.io/developers/commands

Basic commands for project initialization and starting developer mode.

```bash
gaia init         # First-time setup wizard
gaia dev          # Developer mode (Nx TUI)
gaia dev full     # Developer mode + workers (Nx TUI)
```

--------------------------------

### Install GAIA CLI with pnpm

Source: https://docs.heygaia.io/cli/installation

Install the GAIA CLI globally using pnpm. Ensure Node.js 20+ is installed.

```bash
pnpm add -g @heygaia/cli
```

--------------------------------

### Get Help with GAIA Commands

Source: https://docs.heygaia.io/bots/commands

Show all available commands and getting-started information.

```bash
/help
```

--------------------------------

### Install GAIA CLI with npm

Source: https://docs.heygaia.io/cli/installation

Install the GAIA CLI globally using npm. Ensure Node.js 20+ is installed.

```bash
npm install -g @heygaia/cli
```

--------------------------------

### Copy Environment Files

Source: https://docs.heygaia.io/configuration/environment-variables

Copy the example environment files to create your own configuration files for both the API and web applications.

```bash
cp apps/api/.env.example apps/api/.env 
cp apps/web/.env.example apps/web/.env 
```