aui-agent-builder

CLI for importing, editing, and pushing AUI AI agent configurations.

Installation

npm install -g aui-agent-builder

Quick Start

# Authenticate
aui login

# Import an existing agent from the backend
aui import

# Or create a new agent project from scratch
aui init my-agent

# Edit .aui.json files in VSCode/Cursor (autocomplete included)

# Validate your changes
aui validate

# Push changes back
aui push

Commands

| Command | Description | |---------|-------------| | aui login | Authenticate with AUI | | aui list-agents | List agents in your account | | aui create-agent | Create a new agent on the backend | | aui import [agent-id] | Download agent as local .aui.json files | | aui init [directory] | Create a new blank agent project with examples | | aui validate [path] | Validate .aui.json files | | aui push | Upload local changes to the backend | | aui status | Show session and project summary | | aui diff [a] [b] | Compare two agent configs or show changes |

Project Structure

my-agent/
├── general_settings.aui.json   # Agent identity (name, objective, tone, guardrails)
├── parameters.aui.json         # Data parameters the agent works with
├── entities.aui.json           # Groups of related parameters
├── integrations.aui.json       # API/RAG/MCP connections
├── rules.aui.json              # Global behavioral rules
├── tools/                      # One file per agent capability
│   ├── example_search.aui.json
│   └── generative_ai.aui.json
├── GUIDE.md                    # How to build your agent (auto-generated)
├── .vscode/settings.json       # JSON schema autocomplete
└── .aui-schema/aui.schema.json # Schema definition

Workflow

aui login → aui import → edit files → aui validate → aui push
                 ↑                                        │
                 └────────────────────────────────────────┘

1. Login — authenticate with your AUI account
2. Import — download an agent's full configuration as .aui.json files
3. Edit — modify files in your editor (schema autocomplete helps)
4. Validate — check for errors before pushing
5. Push — upload changes back to the backend

Schema Autocomplete

Every project includes a JSON schema that provides:

• Field name suggestions
• Enum value dropdowns (types, actions, methods, operators)
• Descriptions on hover
• Validation highlighting

Works automatically in VSCode and Cursor.

Configuration

Session

~/.aui/session.json — created by aui login, stores auth token and selected account.

Project Config

.auirc — created by aui import or aui init, links the folder to a backend agent.

Environment Variables

| Variable | Description | |----------|-------------| | AUI_AUTH_TOKEN | Auth token (skip login prompt) | | AUI_API_URL | Override backend API URL | | AUI_ENVIRONMENT | staging or production | | AUI_ACCOUNT_ID | Account ID | | AUI_ORGANIZATION_ID | Organization ID | | AUI_AGENT_CODE | Agent code |

License

Proprietary — Copyright (c) 2026 AUI. All rights reserved. See LICENSE.