Skip to main content
Betav0.1.77GA April 2026
npm install -g aui-agent-builder
AUI Agent Builder is a CLI tool for building, managing, and deploying AI agent configurations on the AUI platform. It enables a local-first development workflow: import agents as JSON files, edit them in your IDE with schema autocomplete, validate locally, and push changes back to the cloud. Current version: 0.1.77

​
Quick Start

# 1. Authenticate
aui login

# 2. Import an agent to your local machine
aui import-agent

# 3. Edit .aui.json files in your IDE (VSCode/Cursor get schema autocomplete)

# 4. Validate your changes
aui dvalidate

# 5. Push changes to the cloud
aui push

​
Key Features

Import agent configs as .aui.json files. Edit them in VSCode or Cursor with full JSON schema autocomplete. No web UI required.
Validate agent configurations locally with aui dvalidate before pushing. Catches syntax errors, missing fields, and cross-reference issues.
aui push detects changes via git diff and sends only what changed — PATCH for modified fields, POST for new tools, PUT for upserts.
Use aui chat for real-time streaming conversations with your agent in the terminal. Or run aui serve for a web-based playground.
Switch between staging, custom, and production environments with aui env. Test safely before deploying.

​
How It Works

1

Login

Authenticate with browser login, email + OTP, or access token using aui login.
2

Import

Pull an existing agent’s configuration locally with aui import-agent, or scaffold a new one with aui create-agent.
3

Develop

Edit .aui.json files in your IDE. Schema autocomplete works out of the box in VSCode and Cursor.
4

Validate

Run aui dvalidate to check syntax, required fields, and cross-reference integrity.
5

Push

Deploy changes with aui push. Use --dry-run to preview first.

​
Get Started

Installation

Install the CLI and authenticate with your AUI account.

Command Reference

Full reference for all 16 CLI commands.

Configuration

Project structure, config files, and environment variables.

Workflows

Common development workflows and chat commands.