@aigne/cli 1.26.1-0 → 1.27.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [1.27.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.26.0...cli-v1.27.0) (2025-07-30)
+
+
+### Features
+
+* support aigne connect command and add test ([#283](https://github.com/AIGNE-io/aigne-framework/issues/283)) ([387d22d](https://github.com/AIGNE-io/aigne-framework/commit/387d22d5cacf20abe02a13deaca1f36987d48ba5))
+
+
+### Bug Fixes
+
+* **cli:** replace external dependency with built-in user subscription API ([#292](https://github.com/AIGNE-io/aigne-framework/issues/292)) ([67de7fa](https://github.com/AIGNE-io/aigne-framework/commit/67de7fa521626ee7266c6c527e4eafc227bafa48))
+* support aigne connect status more info ([#290](https://github.com/AIGNE-io/aigne-framework/issues/290)) ([04c5a06](https://github.com/AIGNE-io/aigne-framework/commit/04c5a0625938a7c1ca1d6fd997f6e9047d425ea0))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/aigne-hub bumped to 0.3.0
+
 ## [1.26.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.25.1...cli-v1.26.0) (2025-07-28)
 
 

package/LICENSE.md

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/dist/cli.js

@@ -2,7 +2,6 @@
 import { existsSync, realpathSync, statSync } from "node:fs";
 import chalk from "chalk";
 import { config } from "dotenv-flow";
-import { hideBin } from "yargs/helpers";
 import { createAIGNECommand } from "./commands/aigne.js";
 config({ silent: true });
 function getAIGNEFilePath() {
@@ -17,7 +16,7 @@ function getAIGNEFilePath() {
 }
 const aigneFilePath = getAIGNEFilePath();
 createAIGNECommand({ aigneFilePath })
-    .parseAsync(hideBin([...process.argv.slice(0, 2), ...process.argv.slice(aigneFilePath ? 3 : 2)]))
+    .parseAsync(["", "", ...process.argv.slice(aigneFilePath ? 3 : 2)])
     .catch((error) => {
     console.log(""); // Add an empty line for better readability
     console.error(`${chalk.red("Error:")} ${error.message}`);

package/dist/commands/aigne.d.ts

@@ -1,4 +1,4 @@
-import yargs from "yargs";
+import { Command } from "commander";
 export declare function createAIGNECommand(options?: {
     aigneFilePath?: string;
-}): yargs.Argv<{}>;
+}): Command;

package/dist/commands/aigne.js

@@ -1,7 +1,6 @@
-import yargs from "yargs";
+import { Command } from "commander";
 import { AIGNE_CLI_VERSION } from "../constants.js";
 import { asciiLogo } from "../utils/ascii-logo.js";
-import { createAppCommands } from "./app.js";
 import { createConnectCommand } from "./connect.js";
 import { createCreateCommand } from "./create.js";
 import { createObservabilityCommand } from "./observe.js";
@@ -10,20 +9,16 @@ import { createServeMCPCommand } from "./serve-mcp.js";
 import { createTestCommand } from "./test.js";
 export function createAIGNECommand(options) {
     console.log(asciiLogo);
-    return yargs()
-        .scriptName("aigne")
-        .usage("CLI for AIGNE framework")
+    return new Command()
+        .name("aigne")
+        .description("CLI for AIGNE framework")
         .version(AIGNE_CLI_VERSION)
-        .command(createRunCommand(options))
-        .command(createTestCommand(options))
-        .command(createCreateCommand())
-        .command(createServeMCPCommand(options))
-        .command(createObservabilityCommand())
-        .command(createConnectCommand())
-        .command(createAppCommands())
-        .help()
-        .alias("help", "h")
-        .alias("version", "v")
-        .showHelpOnFail(true)
-        .strict();
+        .addCommand(createRunCommand(options), { isDefault: true })
+        .addCommand(createTestCommand(options))
+        .addCommand(createCreateCommand())
+        .addCommand(createServeMCPCommand(options))
+        .addCommand(createObservabilityCommand())
+        .addCommand(createConnectCommand())
+        .showHelpAfterError(true)
+        .showSuggestionAfterError(true);
 }

package/dist/commands/connect.d.ts

@@ -1,6 +1,2 @@
-import type { CommandModule } from "yargs";
-interface ConnectOptions {
-    url?: string;
-}
-export declare function createConnectCommand(): CommandModule<{}, ConnectOptions>;
-export {};
+import { Command } from "commander";
+export declare function createConnectCommand(): Command;

package/dist/commands/connect.js

@@ -1,8 +1,9 @@
 import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";
-import { getUserInfo } from "@blocklet/aigne-hub/api/user";
 import chalk from "chalk";
+import { Command } from "commander";
 import { parse } from "yaml";
+import { getUserInfo } from "../utils/aigne-hub-user.js";
 import { AIGNE_ENV_FILE, connectToAIGNEHub } from "../utils/load-aigne.js";
 async function getConnectionStatus() {
     if (!existsSync(AIGNE_ENV_FILE)) {
@@ -56,36 +57,30 @@ async function displayStatus(statusList) {
     }
 }
 export function createConnectCommand() {
-    return {
-        command: "connect [url]",
-        describe: "Manage AIGNE Hub connections",
-        builder: (yargs) => {
-            return yargs
-                .positional("url", {
-                describe: "URL to the AIGNE Hub server",
-                type: "string",
-                default: "https://hub.aigne.io/",
-            })
-                .command({
-                command: "status",
-                describe: "Show current connection status",
-                handler: async () => {
-                    const statusList = await getConnectionStatus();
-                    await displayStatus(statusList);
-                },
-            });
-        },
-        handler: async (argv) => {
-            const url = argv.url || "https://hub.aigne.io/";
-            console.log(chalk.blue(`Connecting to AIGNE Hub: ${url}`));
-            try {
-                await connectToAIGNEHub(url);
-                console.log(chalk.green("✓ Successfully connected to AIGNE Hub"));
-            }
-            catch (error) {
-                console.error(chalk.red("✗ Failed to connect to AIGNE Hub:"), error.message);
-                process.exit(1);
-            }
-        },
-    };
+    const connectCommand = new Command("connect")
+        .description("Manage AIGNE Hub connections")
+        .showHelpAfterError(true)
+        .showSuggestionAfterError(true);
+    connectCommand
+        .command("status")
+        .description("Show current connection status")
+        .action(async () => {
+        const statusList = await getConnectionStatus();
+        await displayStatus(statusList);
+    });
+    connectCommand
+        .option("--url <url>", "URL to the AIGNE Hub server")
+        .action(async (options) => {
+        const url = options.url || "https://hub.aigne.io/";
+        console.log(chalk.blue(`Connecting to AIGNE Hub: ${url}`));
+        try {
+            await connectToAIGNEHub(url);
+            console.log(chalk.green("✓ Successfully connected to AIGNE Hub"));
+        }
+        catch (error) {
+            console.error(chalk.red("✗ Failed to connect to AIGNE Hub:"), error.message);
+            process.exit(1);
+        }
+    });
+    return connectCommand;
 }

package/dist/commands/create.d.ts

@@ -1,6 +1,2 @@
-import type { CommandModule } from "yargs";
-interface CreateOptions {
-    path: string;
-}
-export declare function createCreateCommand(): CommandModule<{}, CreateOptions>;
-export {};
+import { Command } from "commander";
+export declare function createCreateCommand(): Command;

package/dist/commands/create.js

@@ -1,73 +1,69 @@
 import { existsSync, mkdirSync, readdirSync } from "node:fs";
 import { cp } from "node:fs/promises";
 import { isAbsolute, join, relative, resolve } from "node:path";
+import { Command } from "commander";
 import inquirer from "inquirer";
 export function createCreateCommand() {
-    return {
-        command: "create [path]",
-        describe: "Create a new aigne project with agent config files",
-        builder: (yargs) => {
-            return yargs.positional("path", {
-                describe: "Path to create the project directory",
-                type: "string",
-                default: ".",
-            });
-        },
-        handler: async ({ path }) => {
-            if (path === ".") {
-                const answers = await inquirer.prompt([
-                    {
-                        type: "input",
-                        name: "projectName",
-                        message: "Project name:",
-                        default: path !== "." ? path : "my-aigne-project",
-                        validate: (input) => {
-                            if (input.trim() === "")
-                                return "Project name cannot be empty.";
-                            return true;
-                        },
-                    },
-                ]);
-                path = answers.projectName;
-            }
-            path = isAbsolute(path) ? path : resolve(process.cwd(), path);
-            const isPathNotEmpty = existsSync(path) && readdirSync(path).length > 0;
-            if (isPathNotEmpty) {
-                const answers = await inquirer.prompt([
-                    {
-                        type: "confirm",
-                        name: "overwrite",
-                        message: `The directory "${path}" is not empty. Do you want to remove its contents?`,
-                        default: false,
+    return new Command("create")
+        .description("Create a new aigne project with agent config files")
+        .argument("[path]", "Path to create the project directory", ".")
+        .action(async (_path) => {
+        let path = _path;
+        if (path === ".") {
+            const answers = await inquirer.prompt([
+                {
+                    type: "input",
+                    name: "projectName",
+                    message: "Project name:",
+                    default: _path !== "." ? _path : "my-aigne-project",
+                    validate: (input) => {
+                        if (input.trim() === "")
+                            return "Project name cannot be empty.";
+                        return true;
                     },
-                ]);
-                if (!answers.overwrite) {
-                    console.log("Operation cancelled.");
-                    process.exit(0);
-                }
-            }
-            const templates = [{ name: "default" }];
-            const { template } = await inquirer.prompt([
+                },
+            ]);
+            path = answers.projectName;
+        }
+        path = isAbsolute(path) ? path : resolve(process.cwd(), path);
+        const isPathNotEmpty = existsSync(path) && readdirSync(path).length > 0;
+        if (isPathNotEmpty) {
+            const answers = await inquirer.prompt([
                 {
-                    type: "list",
-                    name: "template",
-                    message: "Select a template:",
-                    choices: templates.map((t) => t.name),
-                    default: "default",
+                    type: "confirm",
+                    name: "overwrite",
+                    message: `The directory "${path}" is not empty. Do you want to remove its contents?`,
+                    default: false,
                 },
             ]);
-            mkdirSync(path, { recursive: true });
-            const templatePath = join(import.meta.dirname, "../../templates", template);
-            if (!existsSync(templatePath))
-                throw new Error(`Template "${template}" not found.`);
-            const files = readdirSync(templatePath);
-            for (const file of files) {
-                const source = join(templatePath, file);
-                const destination = join(path, file);
-                await cp(source, destination, { recursive: true, force: true });
+            if (!answers.overwrite) {
+                console.log("Operation cancelled.");
+                process.exit(0);
             }
-            console.log("\n✅ AIGNE project created successfully!");
-            console.log(`\nTo use your new agent, run:\n  cd ${relative(process.cwd(), path)} && aigne run`);
-        },
-    };
+        }
+        const templates = [{ name: "default" }];
+        const { template } = await inquirer.prompt([
+            {
+                type: "list",
+                name: "template",
+                message: "Select a template:",
+                choices: templates.map((t) => t.name),
+                default: "default",
+            },
+        ]);
+        mkdirSync(path, { recursive: true });
+        const templatePath = join(import.meta.dirname, "../../templates", template);
+        if (!existsSync(templatePath))
+            throw new Error(`Template "${template}" not found.`);
+        const files = readdirSync(templatePath);
+        for (const file of files) {
+            const source = join(templatePath, file);
+            const destination = join(path, file);
+            await cp(source, destination, { recursive: true, force: true });
+        }
+        console.log("\n✅ AIGNE project created successfully!");
+        console.log(`\nTo use your new agent, run:\n  cd ${relative(process.cwd(), path)} && aigne run`);
+    })
+        .showHelpAfterError(true)
+        .showSuggestionAfterError(true);
 }

package/dist/commands/observe.d.ts

@@ -1,7 +1,2 @@
-import type { CommandModule } from "yargs";
-interface ServeMCPOptions {
-    host: string;
-    port?: number;
-}
-export declare function createObservabilityCommand(): CommandModule<{}, ServeMCPOptions>;
-export {};
+import { Command } from "commander";
+export declare function createObservabilityCommand(): Command;

package/dist/commands/observe.js

@@ -2,6 +2,7 @@ import { tryOrThrow } from "@aigne/core/utils/type-utils.js";
 import { startObservabilityCLIServer } from "@aigne/observability-api/cli";
 import getObservabilityDbPath from "@aigne/observability-api/db-path";
 import chalk from "chalk";
+import { Command } from "commander";
 import detectPort from "detect-port";
 const DEFAULT_PORT = () => tryOrThrow(() => {
     const { PORT } = process.env;
@@ -13,26 +14,16 @@ const DEFAULT_PORT = () => tryOrThrow(() => {
     return port;
 }, (error) => new Error(`parse PORT error ${error.message}`));
 export function createObservabilityCommand() {
-    return {
-        command: "observe",
-        describe: "Start the observability server",
-        builder: (yargs) => {
-            return yargs
-                .option("host", {
-                type: "string",
-                describe: "Host to run the observability server on, use 0.0.0.0 to publicly expose the server",
-                default: "localhost",
-            })
-                .option("port", {
-                type: "number",
-                describe: "Port to run the observability server on",
-            });
-        },
-        handler: async (options) => {
-            const port = await detectPort(options.port || DEFAULT_PORT());
-            const dbUrl = getObservabilityDbPath();
-            console.log("Observability database path:", chalk.greenBright(dbUrl));
-            await startObservabilityCLIServer({ port, dbUrl });
-        },
-    };
+    return new Command("observe")
+        .description("Start the observability server")
+        .option("--host <host>", "Host to run the observability server on, use 0.0.0.0 to publicly expose the server", "localhost")
+        .option("--port <port>", "Port to run the observability server on", (s) => Number.parseInt(s))
+        .action(async (options) => {
+        const port = await detectPort(options.port || DEFAULT_PORT());
+        const dbUrl = getObservabilityDbPath();
+        console.log("Observability database path:", chalk.greenBright(dbUrl));
+        await startObservabilityCLIServer({ port, dbUrl });
+    })
+        .showHelpAfterError(true)
+        .showSuggestionAfterError(true);
 }

package/dist/commands/run.d.ts

@@ -1,7 +1,4 @@
-import type { CommandModule } from "yargs";
-export declare function createRunCommand({ aigneFilePath, }?: {
+import type { Command } from "commander";
+export declare function createRunCommand({ aigneFilePath }?: {
     aigneFilePath?: string;
-}): CommandModule;
-export declare function getLocalPackagePathFromUrl(url: string, { subdir }?: {
-    subdir?: string;
-}): string;
+}): Command;