@aigne/cli 1.30.2 → 1.30.4

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## [1.30.4](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.30.3...cli-v1.30.4) (2025-08-06)
+
+
+### Bug Fixes
+
+* **cli:** improve help display and command handling ([#319](https://github.com/AIGNE-io/aigne-framework/issues/319)) ([306ca5f](https://github.com/AIGNE-io/aigne-framework/commit/306ca5f251d6de356131b11909293be3904d0675))
+* create connect add app info ([#321](https://github.com/AIGNE-io/aigne-framework/issues/321)) ([f0094a3](https://github.com/AIGNE-io/aigne-framework/commit/f0094a3f891617a9822df90918445639cd8c1a90))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.21.13
+    * @aigne/agentic-memory bumped to 1.0.13
+    * @aigne/aigne-hub bumped to 0.4.4
+    * @aigne/openai bumped to 0.10.13
+    * @aigne/core bumped to 1.45.0
+    * @aigne/default-memory bumped to 1.0.13
+
+## [1.30.3](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.30.2...cli-v1.30.3) (2025-08-05)
+
+
+### Bug Fixes
+
+* **cli:** improve CLI prompts and output handling ([#318](https://github.com/AIGNE-io/aigne-framework/issues/318)) ([681ee79](https://github.com/AIGNE-io/aigne-framework/commit/681ee79e9b18aed5a977a0a418c2d9df20a7297c))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.21.12
+    * @aigne/agentic-memory bumped to 1.0.12
+    * @aigne/aigne-hub bumped to 0.4.3
+    * @aigne/openai bumped to 0.10.12
+    * @aigne/core bumped to 1.44.0
+    * @aigne/default-memory bumped to 1.0.12
+
 ## [1.30.2](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.30.1...cli-v1.30.2) (2025-08-05)
 
 

package/dist/cli.js

@@ -17,6 +17,13 @@ function getAIGNEFilePath() {
 }
 const aigneFilePath = getAIGNEFilePath();
 export default createAIGNECommand({ aigneFilePath })
+    .fail((message, error, yargs) => {
+    // We catch all errors below, here just print the help message non-error case like demandCommand
+    if (!error) {
+        yargs.showHelp();
+        console.error(`\n${message}`);
+    }
+})
     .parseAsync(hideBin([...process.argv.slice(0, 2), ...process.argv.slice(aigneFilePath ? 3 : 2)]))
     .catch((error) => {
     console.log(""); // Add an empty line for better readability

package/dist/commands/aigne.js

@@ -11,7 +11,7 @@ import { createServeMCPCommand } from "./serve-mcp.js";
 import { createTestCommand } from "./test.js";
 export function createAIGNECommand(options) {
     console.log(asciiLogo);
-    console.log(`${chalk.grey("TIPS:")} use ${chalk.greenBright("aigne observe")} to start the observability server.\n`);
+    console.log(`${chalk.grey("TIPS:")} run ${chalk.blue("aigne observe")} to start the observability server.\n`);
     return yargs()
         .scriptName("aigne")
         .usage("CLI for AIGNE framework")
@@ -23,9 +23,8 @@ export function createAIGNECommand(options) {
         .command(createObservabilityCommand())
         .command(createConnectCommand())
         .command(createAppCommands())
-        .help()
+        .demandCommand()
         .alias("help", "h")
         .alias("version", "v")
-        .showHelpOnFail(true)
         .strict();
 }

package/dist/commands/app.js

@@ -40,7 +40,7 @@ export function createAppCommands() {
             for (const agent of aigne.cli?.agents ?? []) {
                 yargs.command(agentCommandModule({ dir, agent }));
             }
-            yargs.version(`${app.name} v${version}`);
+            yargs.version(`${app.name} v${version}`).alias("version", "v");
             return yargs.demandCommand();
         },
         handler: () => { },
@@ -77,7 +77,7 @@ const upgradeCommandModule = ({ name, dir, isLatest, version, }) => ({
         if (!isLatest) {
             const result = await loadApplication({ name, dir, forceUpgrade: true });
             if (version !== result.version) {
-                console.log(`\n✅ Upgraded ${name} to version ${version}`);
+                console.log(`\n✅ Upgraded ${name} to version ${result.version}`);
                 return;
             }
         }

package/dist/tracer/terminal.js

@@ -7,10 +7,9 @@ import { flat, omit } from "@aigne/core/utils/type-utils.js";
 import { figures } from "@aigne/listr2";
 import { markedTerminal } from "@aigne/marked-terminal";
 import * as prompts from "@inquirer/prompts";
-import { ListrInquirerPromptAdapter } from "@listr2/prompt-adapter-inquirer";
 import chalk from "chalk";
 import { Marked } from "marked";
-import { AIGNEListr } from "../utils/listr.js";
+import { AIGNEListr, AIGNEListrRenderer } from "../utils/listr.js";
 import { parseDuration } from "../utils/time.js";
 export class TerminalTracer {
     context;
@@ -66,15 +65,17 @@ export class TerminalTracer {
                         get: (_target, prop) => {
                             // biome-ignore lint/performance/noDynamicNamespaceImportAccess: we need to access prompts dynamically
                             const method = prompts[prop];
-                            if (!method)
+                            if (typeof method !== "function")
                                 return undefined;
                             return async (config) => {
-                                const { taskWrapper } = await task.listr.promise;
-                                const result = await taskWrapper
-                                    .prompt(ListrInquirerPromptAdapter)
-                                    .run(method, config);
-                                console.log(`${chalk.blue("✔")} ${chalk.bold(config.message)} ${result}`);
-                                return result;
+                                const renderer = listr["renderer"] instanceof AIGNEListrRenderer ? listr["renderer"] : undefined;
+                                await renderer?.pause();
+                                try {
+                                    return await method({ ...config });
+                                }
+                                finally {
+                                    await renderer?.resume();
+                                }
                             };
                         },
                     }),

package/dist/utils/listr.d.ts

@@ -37,6 +37,12 @@ export declare class AIGNEListrRenderer extends DefaultRenderer {
     get _options(): AIGNEListrRendererOptions;
     get _spinner(): Spinner;
     update(): void;
+    private paused;
+    private ended;
+    end(): void;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    log(message: string): void;
     private isPreviousPrompt;
     create({ running, ...options }: Parameters<DefaultRenderer["create"]>[0] & {
         running?: boolean;

package/dist/utils/listr.js

@@ -58,7 +58,11 @@ export class AIGNEListr extends Listr {
             }
             logger.logMessage = (...args) => this.logs.push(format(...args));
             for (const method of ["debug", "log", "info", "warn", "error"]) {
-                console[method] = (...args) => this.logs.push(format(...args));
+                console[method] = (...args) => {
+                    const renderer = this["renderer"] instanceof AIGNEListrRenderer ? this["renderer"] : undefined;
+                    const msg = format(...args);
+                    renderer ? renderer.log(msg) : this.logs.push(msg);
+                };
             }
             const _stream = await stream();
             this.add({ task: () => this.extractStream(_stream) });
@@ -95,8 +99,32 @@ export class AIGNEListrRenderer extends DefaultRenderer {
         return this["spinner"];
     }
     update() {
+        if (this.paused || this.ended) {
+            return;
+        }
         this._updater(this.create({ running: true }));
     }
+    paused = false;
+    ended = false;
+    end() {
+        this.ended = true;
+        super.end();
+    }
+    async pause() {
+        this.paused = true;
+        this._updater?.clear();
+        this._updater?.done();
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        this._logger.process.release();
+    }
+    async resume() {
+        this._logger.process.hijack();
+        this.paused = false;
+    }
+    log(message) {
+        this._updater?.clear();
+        this._logger.toStdout(message);
+    }
     isPreviousPrompt = false;
     create({ running = false, ...options }) {
         const logs = this._options.aigne?.getStdoutLogs?.();

package/dist/utils/load-aigne.d.ts

@@ -30,6 +30,8 @@ interface CreateConnectOptions {
     retry?: number;
     source?: string;
     connectAction?: string;
+    appName?: string;
+    appLogo?: string;
     wrapSpinner?: typeof baseWrapSpinner;
     prettyUrl?: (url: string) => string;
     closeOnSuccess?: boolean;
@@ -39,7 +41,7 @@ interface CreateConnectOptions {
         fetchTimeout: number;
     }) => Promise<FetchResult>;
 }
-export declare function createConnect({ connectUrl, openPage, fetchInterval, retry, source, connectAction, wrapSpinner, closeOnSuccess, intervalFetchConfig, }: CreateConnectOptions): Promise<FetchResult>;
+export declare function createConnect({ connectUrl, openPage, fetchInterval, retry, source, connectAction, wrapSpinner, closeOnSuccess, intervalFetchConfig, appName, appLogo, }: CreateConnectOptions): Promise<FetchResult>;
 export declare const formatModelName: (models: ReturnType<typeof availableModels>, model: string, inquirerPrompt: typeof inquirer.prompt) => Promise<string>;
 export declare function connectToAIGNEHub(url: string): Promise<{
     accessKey: string;

package/dist/utils/load-aigne.js

@@ -60,7 +60,7 @@ export const fetchConfigs = async ({ connectUrl, sessionId, fetchInterval, fetch
 function baseWrapSpinner(_, waiting) {
     return Promise.resolve(waiting());
 }
-export async function createConnect({ connectUrl, openPage, fetchInterval = 3 * 1000, retry = 1500, source = "Blocklet CLI", connectAction = "connect-cli", wrapSpinner = baseWrapSpinner, closeOnSuccess, intervalFetchConfig, }) {
+export async function createConnect({ connectUrl, openPage, fetchInterval = 3 * 1000, retry = 1500, source = "Blocklet CLI", connectAction = "connect-cli", wrapSpinner = baseWrapSpinner, closeOnSuccess, intervalFetchConfig, appName = "AIGNE CLI", appLogo = "https://www.aigne.io/favicon.ico?imageFilter=resize&w=32", }) {
     try {
         const startSessionURL = joinURL(connectUrl, ACCESS_KEY_SESSION_API);
         const { data: session } = await request({ url: startSessionURL, method: "POST" });
@@ -70,8 +70,8 @@ export async function createConnect({ connectUrl, openPage, fetchInterval = 3 *
             source,
             closeOnSuccess,
             cli: true,
-            appName: " AIGNE CLI",
-            appLogo: "https://www.aigne.io/favicon.ico?imageFilter=resize&w=32",
+            appName: ` ${appName}`,
+            appLogo,
         });
         openPage?.(pageUrl);
         return await wrapSpinner(`Waiting for connection: ${connectUrl}`, async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.30.2",
+  "version": "1.30.4",
   "description": "Command-line interface for AIGNE Framework - A functional AI application development framework for building scalable AI-powered applications with workflow patterns, MCP protocol integration, and multi-model support",
   "publishConfig": {
     "access": "public"
@@ -73,12 +73,12 @@
     "yaml": "^2.8.0",
     "yargs": "^18.0.0",
     "zod": "^3.25.67",
-    "@aigne/agent-library": "^1.21.11",
-    "@aigne/agentic-memory": "^1.0.11",
-    "@aigne/aigne-hub": "^0.4.2",
-    "@aigne/openai": "^0.10.11",
-    "@aigne/default-memory": "^1.0.11",
-    "@aigne/core": "^1.43.1",
+    "@aigne/agent-library": "^1.21.13",
+    "@aigne/aigne-hub": "^0.4.4",
+    "@aigne/agentic-memory": "^1.0.13",
+    "@aigne/openai": "^0.10.13",
+    "@aigne/core": "^1.45.0",
+    "@aigne/default-memory": "^1.0.13",
     "@aigne/observability-api": "^0.9.0"
   },
   "devDependencies": {