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:
npm install -g @heygaia/cli
Verify Installation
gaia --version
gaia --help
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:
cd /path/to/gaia
git pull
If the update includes dependency changes, run gaia setup afterwards.
Updating the CLI
npm install -g @heygaia/cli
Uninstalling
To fully remove GAIA from your machine:
- Stop all running services:
- Delete the GAIA repository directory:
- Remove CLI metadata:
- Uninstall the CLI:
npm uninstall -g @heygaia/cli
Next Steps
