@aigne/cli 1.34.0 → 1.35.1

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## [1.35.1](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.35.0...cli-v1.35.1) (2025-08-13)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/aigne-hub bumped to 0.5.1
+
+## [1.35.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.34.1...cli-v1.35.0) (2025-08-13)
+
+
+### Features
+
+* **cli:** support aigne hub commond ([#352](https://github.com/AIGNE-io/aigne-framework/issues/352)) ([0341f19](https://github.com/AIGNE-io/aigne-framework/commit/0341f190229b42c5d2ab8a8616597359f35543a7))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/aigne-hub bumped to 0.5.0
+
+## [1.34.1](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.34.0...cli-v1.34.1) (2025-08-12)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.21.19
+    * @aigne/agentic-memory bumped to 1.0.19
+    * @aigne/aigne-hub bumped to 0.4.10
+    * @aigne/core bumped to 1.49.1
+    * @aigne/default-memory bumped to 1.1.1
+    * @aigne/openai bumped to 0.11.1
+
 ## [1.34.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.33.1...cli-v1.34.0) (2025-08-12)
 
 

package/dist/commands/aigne.js

@@ -3,8 +3,8 @@ import yargs from "yargs";
 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 { createHubCommand } from "./hub.js";
 import { createObservabilityCommand } from "./observe.js";
 import { createRunCommand } from "./run.js";
 import { createServeMCPCommand } from "./serve-mcp.js";
@@ -21,8 +21,8 @@ export function createAIGNECommand(options) {
         .command(createCreateCommand())
         .command(createServeMCPCommand(options))
         .command(createObservabilityCommand())
-        .command(createConnectCommand())
         .command(createAppCommands())
+        .command(createHubCommand())
         .demandCommand()
         .alias("help", "h")
         .alias("version", "v")

package/dist/commands/hub.d.ts

@@ -0,0 +1,2 @@
+import type { CommandModule } from "yargs";
+export declare function createHubCommand(): CommandModule;

package/dist/commands/hub.js

@@ -0,0 +1,271 @@
+import { existsSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { AIGNE_ENV_FILE, AIGNE_HUB_URL, connectToAIGNEHub, isTest } from "@aigne/aigne-hub";
+import chalk from "chalk";
+import Table from "cli-table3";
+import inquirer from "inquirer";
+import { parse, stringify } from "yaml";
+import { getUserInfo } from "../utils/aigne-hub-user.js";
+const formatNumber = (balance) => {
+    const balanceNum = String(balance).split(".")[0];
+    return chalk.yellow((balanceNum || "").replace(/\B(?=(\d{3})+(?!\d))/g, ","));
+};
+function printHubStatus(data) {
+    const divider = "─".repeat(46);
+    console.log(chalk.bold("AIGNE Hub Connection"));
+    console.log(chalk.gray(divider));
+    console.log(`${chalk.bold("Hub:".padEnd(10))} ${data.hub}`);
+    console.log(`${chalk.bold("Status:".padEnd(10))} ${data.status === "Connected"
+        ? chalk.green(`${data.status} ✅`)
+        : chalk.red(`${data.status} ❌`)}`);
+    console.log("");
+    console.log(chalk.bold("User:"));
+    console.log(`  ${chalk.bold("Name:".padEnd(8))} ${data.user.name}`);
+    console.log(`  ${chalk.bold("DID:".padEnd(8))} ${data.user.did}`);
+    console.log(`  ${chalk.bold("Email:".padEnd(8))} ${data.user.email}`);
+    console.log("");
+    console.log(chalk.bold("Credits:"));
+    console.log(`  ${chalk.bold("Used:".padEnd(8))} ${data.credits.used.toLocaleString()}`);
+    console.log(`  ${chalk.bold("Total:".padEnd(8))} ${data.credits.total.toLocaleString()}`);
+    console.log("");
+    console.log(chalk.bold("Links:"));
+    console.log(`  ${chalk.bold("Payment:".padEnd(8))} ${data.links.payment}`);
+    console.log(`  ${chalk.bold("Profile:".padEnd(8))} ${data.links.profile}`);
+}
+async function getHubs() {
+    if (!existsSync(AIGNE_ENV_FILE)) {
+        return [];
+    }
+    try {
+        const data = await readFile(AIGNE_ENV_FILE, "utf8");
+        const envs = parse(data);
+        const statusList = [];
+        for (const [host, config] of Object.entries(envs)) {
+            if (host !== "default") {
+                statusList.push({
+                    host,
+                    apiUrl: config.AIGNE_HUB_API_URL,
+                    apiKey: config.AIGNE_HUB_API_KEY,
+                });
+            }
+        }
+        return statusList;
+    }
+    catch {
+        return [];
+    }
+}
+const getDefaultHub = async () => {
+    const envs = parse(await readFile(AIGNE_ENV_FILE, "utf8").catch(() => stringify({})));
+    return envs?.default?.AIGNE_HUB_API_URL || AIGNE_HUB_URL;
+};
+async function formatHubsList(statusList) {
+    if (statusList?.length === 0) {
+        console.log(chalk.yellow("No AIGNE Hub configured."));
+        console.log("Use 'aigne hub connect' to connect to a hub.");
+        return;
+    }
+    const defaultHub = await getDefaultHub();
+    const table = new Table({
+        head: ["URL", "ACTIVE", "STATUS"],
+        colWidths: [50, 10, 20],
+        style: {
+            head: ["cyan"],
+            border: ["grey"],
+        },
+    });
+    console.log(chalk.blue("AIGNE Hubs:\n"));
+    for (const status of statusList) {
+        const isConnected = new URL(status.apiUrl).origin === new URL(defaultHub).origin;
+        table.push([
+            status.apiUrl,
+            isConnected ? "*" : "-",
+            isConnected ? "Connected" : "Not connected",
+        ]);
+    }
+    console.log(table.toString());
+}
+export function createHubCommand() {
+    return {
+        command: "hub <command>",
+        describe: "Manage AIGNE Hub connections",
+        builder: (yargs) => yargs
+            .command(["list", "ls"], "List all connected AIGNE Hubs", listHubs)
+            .command("connect", "Connect to an AIGNE Hub", connectHub)
+            .command("use", "Switch to a different AIGNE Hub", useHub)
+            .command(["status", "st"], "Show current active hub", showStatus)
+            .command(["remove", "rm"], "Remove a connected hub", removeHub)
+            .command(["info", "i"], "Show details of a connected hub", showInfo)
+            .demandCommand(1, "Please provide a valid hub command"),
+        handler: () => { },
+    };
+}
+const listHubs = async () => {
+    const list = await getHubs();
+    await formatHubsList(list);
+};
+async function connectHub() {
+    const defaultUrl = "https://hub.aigne.io";
+    const { isOfficial } = await inquirer.prompt({
+        type: "select",
+        name: "isOfficial",
+        message: `Choose a hub to connect:`,
+        choices: [
+            { name: `Official Hub (${defaultUrl})`, value: true },
+            { name: `Custom Hub URL`, value: false },
+        ],
+        default: true,
+    });
+    let currentUrl = defaultUrl;
+    if (!isOfficial) {
+        const { customUrl } = await inquirer.prompt({
+            type: "input",
+            name: "customUrl",
+            message: "Enter the URL of your AIGNE Hub:",
+            validate: validateUrl,
+        });
+        currentUrl = customUrl;
+    }
+    await saveAndConnect(currentUrl);
+}
+async function useHub() {
+    const hubs = await getHubs();
+    if (!hubs.length) {
+        console.log(chalk.yellow("No AIGNE Hub configured."));
+        return;
+    }
+    const { hubApiKey } = await inquirer.prompt({
+        type: "select",
+        name: "hubApiKey",
+        message: `Choose a hub to switch to:`,
+        choices: hubs.map((h) => ({
+            name: new URL(h.apiUrl).origin,
+            value: h.apiUrl,
+        })),
+    });
+    await setDefaultHub(hubApiKey);
+}
+async function showStatus() {
+    const active = await getDefaultHub();
+    if (!active) {
+        console.log(chalk.red("No active hub."));
+        return;
+    }
+    console.log(`Active hub: ${active} - online`);
+}
+async function removeHub() {
+    const hubs = await getHubs();
+    if (!hubs.length) {
+        console.log(chalk.yellow("No AIGNE Hub configured."));
+        return;
+    }
+    const { hubApiKey } = await inquirer.prompt({
+        type: "select",
+        name: "hubApiKey",
+        message: `Choose a hub to remove:`,
+        choices: hubs.map((h) => ({
+            name: new URL(h.apiUrl).origin,
+            value: h.apiUrl,
+        })),
+    });
+    await deleteHub(hubApiKey);
+}
+async function showInfo() {
+    const hubs = await getHubs();
+    if (!hubs.length) {
+        console.log(chalk.yellow("No AIGNE Hub configured."));
+        return;
+    }
+    const { hubApiKey } = await inquirer.prompt({
+        type: "select",
+        name: "hubApiKey",
+        message: `Choose a hub to view info:`,
+        choices: hubs.map((h) => ({
+            name: new URL(h.apiUrl).origin,
+            value: h.apiUrl,
+        })),
+    });
+    await printHubDetails(hubApiKey);
+}
+function validateUrl(input) {
+    try {
+        const url = new URL(input);
+        return url.protocol.startsWith("http") ? true : "Must be http or https";
+    }
+    catch {
+        return "Invalid URL";
+    }
+}
+async function saveAndConnect(url) {
+    const envs = parse(await readFile(AIGNE_ENV_FILE, "utf8").catch(() => stringify({})));
+    const host = new URL(url).host;
+    if (envs[host]) {
+        await setDefaultHub(envs[host]?.AIGNE_HUB_API_URL || "");
+        console.log(chalk.green(`✓ Hub ${envs[host]?.AIGNE_HUB_API_URL} connected successfully.`));
+        return;
+    }
+    try {
+        if (isTest) {
+            writeFile(AIGNE_ENV_FILE, stringify({
+                "hub.aigne.io": {
+                    AIGNE_HUB_API_KEY: "test-key",
+                    AIGNE_HUB_API_URL: "https://hub.aigne.io/ai-kit",
+                },
+                default: {
+                    AIGNE_HUB_API_URL: "https://hub.aigne.io/ai-kit",
+                },
+            }));
+            return;
+        }
+        await connectToAIGNEHub(url);
+        console.log(chalk.green(`✓ Hub ${url} connected successfully.`));
+    }
+    catch (error) {
+        console.error(chalk.red("✗ Failed to connect:"), error.message);
+    }
+}
+async function setDefaultHub(url) {
+    const envs = parse(await readFile(AIGNE_ENV_FILE, "utf8").catch(() => stringify({})));
+    const host = new URL(url).host;
+    if (!envs[host]) {
+        console.error(chalk.red("✗ Hub not found"));
+        return;
+    }
+    await writeFile(AIGNE_ENV_FILE, stringify({ ...envs, default: { AIGNE_HUB_API_URL: envs[host]?.AIGNE_HUB_API_URL } }));
+    console.log(chalk.green(`✓ Switched active hub to ${url}`));
+}
+async function deleteHub(url) {
+    const envs = parse(await readFile(AIGNE_ENV_FILE, "utf8").catch(() => stringify({})));
+    const host = new URL(url).host;
+    delete envs[host];
+    if (envs.default?.AIGNE_HUB_API_URL && new URL(envs.default?.AIGNE_HUB_API_URL).host === host) {
+        delete envs.default;
+    }
+    await writeFile(AIGNE_ENV_FILE, stringify(envs));
+    console.log(chalk.green(`✓ Hub ${url} removed`));
+}
+async function printHubDetails(url) {
+    const envs = parse(await readFile(AIGNE_ENV_FILE, "utf8").catch(() => stringify({})));
+    const host = new URL(url).host;
+    const userInfo = await getUserInfo({
+        baseUrl: envs[host]?.AIGNE_HUB_API_URL || "",
+        apiKey: envs[host]?.AIGNE_HUB_API_KEY || "",
+    }).catch(() => null);
+    printHubStatus({
+        hub: url,
+        status: userInfo ? "Connected" : "Not connected",
+        user: {
+            name: userInfo?.user.fullName || "",
+            did: userInfo?.user.did || "",
+            email: userInfo?.user.email || "",
+        },
+        credits: {
+            used: formatNumber(userInfo?.creditBalance?.balance || "0"),
+            total: formatNumber(userInfo?.creditBalance?.total || "0"),
+        },
+        links: {
+            payment: userInfo?.paymentLink || "",
+            profile: userInfo?.profileLink || "",
+        },
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.34.0",
+  "version": "1.35.1",
   "description": "Your command center for agent development",
   "publishConfig": {
     "access": "public"
@@ -53,6 +53,7 @@
     "@modelcontextprotocol/sdk": "^1.15.0",
     "@smithy/node-http-handler": "^4.1.0",
     "chalk": "^5.4.1",
+    "cli-table3": "^0.6.5",
     "detect-port": "^2.1.0",
     "dotenv-flow": "^4.1.0",
     "express": "^5.1.0",
@@ -63,7 +64,6 @@
     "log-update": "^6.1.0",
     "marked": "^16.0.0",
     "nunjucks": "^3.2.4",
-    "open": "10.1.2",
     "openai": "^5.8.3",
     "prettier": "^3.6.2",
     "tar": "^7.4.3",
@@ -71,13 +71,13 @@
     "yaml": "^2.8.0",
     "yargs": "^18.0.0",
     "zod": "^3.25.67",
-    "@aigne/agent-library": "^1.21.18",
-    "@aigne/agentic-memory": "^1.0.18",
-    "@aigne/aigne-hub": "^0.4.9",
-    "@aigne/core": "^1.49.0",
-    "@aigne/default-memory": "^1.1.0",
+    "@aigne/agent-library": "^1.21.19",
+    "@aigne/agentic-memory": "^1.0.19",
+    "@aigne/aigne-hub": "^0.5.1",
+    "@aigne/core": "^1.49.1",
     "@aigne/observability-api": "^0.9.0",
-    "@aigne/openai": "^0.11.0"
+    "@aigne/openai": "^0.11.1",
+    "@aigne/default-memory": "^1.1.1"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",

package/dist/commands/connect.d.ts

@@ -1,13 +0,0 @@
-import type { CommandModule } from "yargs";
-interface ConnectOptions {
-    url?: string;
-}
-interface StatusInfo {
-    host: string;
-    apiUrl: string;
-    apiKey: string;
-}
-export declare function getConnectionStatus(): Promise<StatusInfo[]>;
-export declare function displayStatus(statusList: StatusInfo[]): Promise<void>;
-export declare function createConnectCommand(): CommandModule<unknown, ConnectOptions>;
-export {};

package/dist/commands/connect.js

@@ -1,125 +0,0 @@
-import { existsSync } from "node:fs";
-import { readFile, writeFile } from "node:fs/promises";
-import { AIGNE_ENV_FILE, AIGNE_HUB_URL, connectToAIGNEHub } from "@aigne/aigne-hub";
-import chalk from "chalk";
-import { parse, stringify } from "yaml";
-import { getUserInfo } from "../utils/aigne-hub-user.js";
-const formatNumber = (balance) => {
-    const balanceNum = String(balance).split(".")[0];
-    return chalk.yellow((balanceNum || "").replace(/\B(?=(\d{3})+(?!\d))/g, ","));
-};
-export async function getConnectionStatus() {
-    if (!existsSync(AIGNE_ENV_FILE)) {
-        return [];
-    }
-    try {
-        const data = await readFile(AIGNE_ENV_FILE, "utf8");
-        const envs = parse(data);
-        const statusList = [];
-        for (const [host, config] of Object.entries(envs)) {
-            statusList.push({
-                host,
-                apiUrl: config.AIGNE_HUB_API_URL,
-                apiKey: config.AIGNE_HUB_API_KEY,
-            });
-        }
-        return statusList;
-    }
-    catch {
-        return [];
-    }
-}
-export async function displayStatus(statusList) {
-    if (statusList.length === 0) {
-        console.log(chalk.yellow("No AIGNE Hub connections found."));
-        console.log("Use 'aigne connect <url>' to connect to a hub.");
-        return;
-    }
-    console.log(chalk.cyan("AIGNE Hub Connection Status:\n"));
-    const defaultStatus = statusList.find((status) => status.host === "default")?.apiUrl || AIGNE_HUB_URL;
-    for (const status of statusList.filter((status) => status.host !== "default")) {
-        const userInfo = await getUserInfo({ baseUrl: status.apiUrl, apiKey: status.apiKey }).catch(() => null);
-        const isConnected = new URL(status.apiUrl).origin === new URL(defaultStatus).origin;
-        const statusIcon = isConnected ? chalk.green("✓") : "•";
-        const statusText = isConnected ? "Connected" : "Not connected";
-        console.log(`${statusIcon} ${chalk.bold(status.host)}`);
-        console.log(`   Status: ${statusText}`);
-        if (userInfo) {
-            console.log(`   User: ${userInfo?.user.fullName}`);
-            console.log(`   User DID: ${userInfo?.user.did}`);
-            if (userInfo?.user.email) {
-                console.log(`   Email: ${userInfo?.user.email}`);
-            }
-            if (userInfo?.creditBalance) {
-                const balance = formatNumber(userInfo?.creditBalance?.balance);
-                const total = formatNumber(userInfo?.creditBalance?.total);
-                console.log(`   Credits: ${balance} / ${total}`);
-            }
-            console.log(`   Payment URL: ${userInfo?.paymentLink ? chalk.green(userInfo.paymentLink) : chalk.red("N/A")}`);
-            console.log(`   Profile URL: ${userInfo?.profileLink ? chalk.green(userInfo.profileLink) : chalk.red("N/A")}`);
-        }
-        console.log("");
-    }
-}
-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);
-                },
-            })
-                .command({
-                command: "switch",
-                describe: "Switch to a different AIGNE Hub",
-                handler: async (argv) => {
-                    const url = argv.url;
-                    console.log("Switching to AIGNE Hub: ", chalk.blue(url));
-                    if (!url) {
-                        console.error(chalk.red("✗ Please provide a URL to the AIGNE Hub server"));
-                        process.exit(1);
-                    }
-                    const data = await readFile(AIGNE_ENV_FILE, "utf8");
-                    const envs = parse(data);
-                    let host = "";
-                    try {
-                        host = new URL(url).host;
-                    }
-                    catch {
-                        console.error(chalk.red("✗ Invalid URL"));
-                        process.exit(1);
-                    }
-                    if (!envs[host]) {
-                        console.error(chalk.red("✗ AIGNE Hub already connected"));
-                        process.exit(1);
-                    }
-                    await writeFile(AIGNE_ENV_FILE, stringify({ ...envs, default: { AIGNE_HUB_API_URL: envs[host]?.AIGNE_HUB_API_URL } }));
-                    console.log(chalk.green("✓ Successfully connected to AIGNE Hub"));
-                },
-            });
-        },
-        handler: async (argv) => {
-            const url = argv.url || "https://hub.aigne.io/";
-            console.log(chalk.cyan(`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);
-            }
-        },
-    };
-}