AUI Agent Builder
Build, manage, and deploy AUI AI agents directly from VS Code and Cursor.
The official AUI extension brings the full power of the AUI CLI into your editor — inline validation, schema autocomplete, MCP integration management, version lifecycle, knowledge base operations, and one-click publishing.
Highlights
- Inline Validation — Save any
.aui.json file and errors appear instantly in the Problems panel. No terminal needed.
- Schema Autocomplete — Full JSON IntelliSense for
*.aui.json files with hover docs and type checking.
- MCP Integrations — Create and discover MCP tool integrations (manual URL or Composio native with OAuth).
- Version Lifecycle — Create, publish, activate, archive, and update agent versions without leaving the editor.
- Knowledge Base — Upload files, manage RAG knowledge bases, and export data from the sidebar.
- Push & Pull — Sync your local agent configuration with the AUI backend in one click.
- Chat — Test your agent in an interactive terminal chat or the web playground.
Agent Panel
Your command center — always shows the current organization, account, agent, and environment at a glance.
Configuration — Organization, account, agent, and environment with click-to-switch.
Version — Current version indicator plus one-click actions for the full lifecycle:
Create → Publish → Activate → Archive → Update
Actions — Push, Pull, Import, Diff, Validate, Pull Schema, Revert, Knowledge Base, Chat, and Playground.
Integrations Panel
Dedicated panel for MCP integration management:
- Create Integration — Set up manual MCP server connections or Composio native integrations with OAuth
- Discover Tools — Probe any MCP server URL to list its available tools
CodeLens
Quick-action buttons appear directly above every .aui.json file:
Push · Pull · Validate · Diff · Create Version · Integration · Playground
Status Bar
A persistent indicator in the bottom bar shows your current agent and environment:
⬡ AUI: my-agent [production]
Hover for full details (agent, version, environment, account). Click to show status.
Keyboard Shortcuts
| Action |
Mac |
Windows / Linux |
| Push Changes |
⌘⇧U |
Ctrl+Shift+U |
| Validate Config |
⌘⇧V |
Ctrl+Shift+V |
Requirements
| Dependency |
Version |
Install |
| Node.js |
20+ |
nodejs.org |
| Git |
2.x+ |
git-scm.com |
| AUI CLI |
latest |
npm install -g aui-agent-builder |
The AUI CLI is available on npm: aui-agent-builder
You also need an AUI account — sign up at aui.io.
Getting Started
- Install the AUI CLI:
npm install -g aui-agent-builder
- Login — Command Palette (
⌘⇧P) → AUI: Login → select environment → authenticate via browser OAuth or email OTP
- Create or Import —
AUI: Create Agent to start fresh, or AUI: Import Agent to pull an existing agent
- Open the agent folder — the AUI sidebar activates automatically when
.auirc or *.aui.json files are detected
- Pull Schema —
AUI: Pull Schema & Rules to enable JSON autocomplete and AI coding rules
- Edit your
.aui.json files — validation runs on save, errors appear in the Problems panel
- Push —
⌘⇧U or click Push in the sidebar when ready
Tip: The built-in walkthrough (Help → Get Started) guides you through each step.
All Commands
Authentication & Context
| Command |
Description |
AUI: Login |
Authenticate via browser OAuth or email OTP |
AUI: Logout |
Sign out and clear local session |
AUI: Switch Agent |
Switch to a different agent |
AUI: Switch Account |
Switch to a different account |
AUI: Switch Environment |
Toggle between production / staging / custom |
AUI: Show Status |
Display current session info in the output panel |
Agent Management
| Command |
Description |
AUI: Create Agent |
Create a new agent interactively |
AUI: Import Agent |
Download an existing agent to a local folder |
AUI: Open Agent Folder |
Open an existing agent project |
AUI: Push Changes |
Upload local .aui.json changes to AUI |
AUI: Pull Agent Files |
Download latest agent files from the backend |
AUI: Validate Agent Config |
Validate config and show errors in the Problems panel |
AUI: Diff (Local vs Backend) |
Compare local files against the last import snapshot |
AUI: Pull Schema & Rules |
Download JSON schemas and AI coding-assistant rules |
AUI: Revert Changes |
Reset local files to the last imported state |
Version Lifecycle
| Command |
Description |
AUI: Create New Version |
Snapshot the current config as a new draft |
AUI: Publish Version |
Publish a draft version (locks it permanently) |
AUI: Activate Version |
Make a published version live |
AUI: Archive Version |
Archive a published version |
AUI: Update Version |
Update label, tags, or notes on a version |
AUI: List Versions |
Show all versions in the terminal |
Integrations
| Command |
Description |
AUI: Create Integration |
Create an MCP integration — manual URL or Composio native with OAuth |
AUI: Discover Integration Tools |
Discover available tools from an MCP server |
Knowledge Base & Chat
| Command |
Description |
AUI: Knowledge Base (RAG) |
Manage knowledge bases — list, upload, export, import |
AUI: Chat with Agent |
Interactive terminal chat with your agent |
AUI: Open Chat Playground |
Launch the web-based chat playground |
AUI: Open Documentation |
Open AUI docs in the browser |
Extension Settings
| Setting |
Default |
Description |
aui.cliPath |
"aui" |
Path to the AUI CLI executable |
aui.autoValidateOnSave |
true |
Validate .aui.json files automatically on save |
aui.showStatusBar |
true |
Show agent and environment in the status bar |
aui.confirmBeforePublish |
true |
Ask for confirmation before publishing or activating |
Supported Editors
- VS Code 1.85+
- Cursor — fully compatible, all features work
Feedback & Issues
Report bugs or request features at the AUI CLI repository or visit docs.aui.io.
