aui-agent-builder 0.1.87 → 0.1.89

package/README.md

@@ -562,6 +562,80 @@ aui chat --rest                   # REST only, no streaming
 | `AUI_AGENT_TOOLS_API_KEY` | Agent Settings API key (fallback auth)                |
 | `AUI_API_WORKFLOW_KEY`    | API Workflow key                                      |
 
+## Local Development
+
+To run the CLI from your local source code instead of the published npm package:
+
+```bash
+cd aui-agent-builder
+npm install
+npm run build
+npm link
+```
+
+This creates a global `aui` symlink pointing to your local build. Any changes you make are reflected after running `npm run build` again.
+
+To verify you're running the local version:
+
+```bash
+which aui
+# Should show a path inside your project, not a global npm path
+```
+
+To switch back to the published version:
+
+```bash
+npm uninstall -g aui-agent-builder
+npm install -g aui-agent-builder
+```
+
+## Updating
+
+### Update Notifications
+
+The CLI automatically checks for new versions once every 24 hours. When an update is available, a banner appears after command output:
+
+```
+╭──────────────────────────────────────────────╮
+│  Update available: 0.1.86 → 0.1.87          │
+│  Run: npm install -g aui-agent-builder       │
+╰──────────────────────────────────────────────╯
+```
+
+The check is non-blocking and never affects CLI performance. For Homebrew users, the banner shows `brew upgrade aui` instead.
+
+### Upgrade Command
+
+Upgrade directly from the CLI:
+
+```bash
+aui upgrade
+```
+
+This automatically detects whether you installed via npm or Homebrew and runs the appropriate upgrade command.
+
+### Manual Upgrade
+
+```bash
+# npm
+npm install -g aui-agent-builder
+
+# Homebrew
+brew upgrade aui
+```
+
+### Disable Update Notifications
+
+```bash
+# Environment variable
+AUI_NO_UPDATE_CHECK=1 aui status
+
+# Or use ecosystem-standard flag
+NO_UPDATE_NOTIFIER=1 aui status
+```
+
+Update notifications are also automatically suppressed in CI environments (`CI=true`) and when using `--quiet`, `--json`, or `--silent` flags.
+
 ## License
 
 Proprietary — Copyright (c) 2026 AUI. All rights reserved. See [LICENSE](./LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aui-agent-builder",
-  "version": "0.1.87",
+  "version": "0.1.89",
   "description": "CLI for building, managing, and deploying AUI AI agent configurations",
   "type": "module",
   "main": "dist/index.js",