Skip to main content
GAIA CLI terminal interface

​
Install the CLI

The GAIA CLI (@heygaia/cli) is a terminal-based tool for setting up, configuring, and managing GAIA instances. Install globally with your package manager:

​
Verify Installation

If gaia is not available immediately, open a new terminal session and run gaia --help again.

​
Requirements

  • macOS, Linux, or Windows (WSL2 recommended)
  • Node.js 20+ and one package manager (npm, pnpm, or bun)
  • Docker installed and running
  • Git installed
The CLI checks prerequisites during setup and guides you if something is missing.

​
Upgrading

​
Updating GAIA

Pull the latest changes from your GAIA repo directory:
If the update includes dependency changes, run gaia setup afterwards.

​
Updating the CLI

​
Uninstalling

To fully remove GAIA from your machine:
  1. Stop all running services:
  1. Delete the GAIA repository directory:
  1. Remove CLI metadata:
  1. Uninstall the CLI:

​
Next Steps

Commands Reference

See all available CLI commands

First-Time Setup

Set up GAIA from scratch using the CLI wizard