Installation

System Requirements

npm install -g aui-agent-builder

Verify the installation:

aui --version

AUI supports three authentication methods:

Opens the AUI playground login page. Your token is received automatically via a local callback.

aui login

The CLI will open your browser. Sign in, and you’ll be redirected back automatically.

Enter your email, then paste the verification code sent to your inbox.

aui login --email user@example.com

Paste a JWT directly — useful for CI/CD or when copying from browser DevTools.

aui login --token <jwt>

Authenticate with an API key and account ID.

aui login --api-key <key> --account-id <id>

After authenticating, the CLI walks you through selecting your Organization, Account, and Agent.

Session credentials are stored in ~/.aui/session.json. They persist across terminal sessions.

Verify your session

aui status

You should see your account info, active agent, and current environment.

Set your environment

aui env staging      # Development and testing
aui env production   # Live environment
aui env custom       # Custom environment

The active environment is stored in ~/.aui/environment.

Import or create an agent

# Import an existing agent
aui import-agent

# Or scaffold a new one
aui create-agent ./my-agent

npm uninstall -g aui-agent-builder

To remove stored credentials and session data:

rm -rf ~/.aui

This removes all stored sessions, API keys, and cached schemas. You’ll need to run aui login again.