@aigne/cli 1.31.0 → 1.32.1

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [1.32.1](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.32.0...cli-v1.32.1) (2025-08-08)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.21.15
+    * @aigne/agentic-memory bumped to 1.0.15
+    * @aigne/aigne-hub bumped to 0.4.6
+    * @aigne/core bumped to 1.46.1
+    * @aigne/default-memory bumped to 1.0.15
+    * @aigne/openai bumped to 0.10.15
+
+## [1.32.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.31.0...cli-v1.32.0) (2025-08-07)
+
+
+### Features
+
+* **cli:** support config custom AIGNE Hub service URL ([#330](https://github.com/AIGNE-io/aigne-framework/issues/330)) ([21d30c8](https://github.com/AIGNE-io/aigne-framework/commit/21d30c8c75d9f27cb257d92434ba63e38e06f468))
+
+
+### Bug Fixes
+
+* **cli:** properly handle boolean and number types in agent options ([#331](https://github.com/AIGNE-io/aigne-framework/issues/331)) ([c9f4209](https://github.com/AIGNE-io/aigne-framework/commit/c9f4209ec1b236bc54e8aaef0b960e10a380e375))
+
 ## [1.31.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.30.4...cli-v1.31.0) (2025-08-06)
 
 

package/README.md

@@ -6,6 +6,8 @@
     <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/packages/cli/logo.svg" media="(prefers-color-scheme: light)">
     <img src="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/packages/cli/logo.svg" alt="AIGNE Logo" width="400" />
   </picture>
+
+  <center>Your command center for agent development</center>
 </p>
 
 [![GitHub star chart](https://img.shields.io/github/stars/AIGNE-io/aigne-framework?style=flat-square)](https://star-history.com/#AIGNE-io/aigne-framework)
@@ -20,6 +22,12 @@ Command-line tool for [AIGNE Framework](https://github.com/AIGNE-io/aigne-framew
 
 `@aigne/cli` is the official command-line tool for [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework), designed to simplify the development, testing, and deployment processes for AIGNE applications. It provides a series of useful commands to help developers quickly create projects, run agents, test code, and deploy applications.
 
+<picture>
+  <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/assets/aigne-cli-dark.png" media="(prefers-color-scheme: dark)">
+  <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/assets/aigne-cli.png" media="(prefers-color-scheme: light)">
+  <img src="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/aigne-cli.png" alt="AIGNE Arch" />
+</picture>
+
 ## Features
 
 * **Project Creation**: Quickly create new AIGNE projects with predefined file structures and configurations

package/dist/commands/app.js

@@ -10,7 +10,7 @@ import { pick } from "@aigne/core/utils/type-utils.js";
 import { Listr, PRESET_TIMER } from "@aigne/listr2";
 import { joinURL } from "ufo";
 import { parse } from "yaml";
-import { ZodObject, ZodString } from "zod";
+import { ZodBoolean, ZodNumber, ZodObject, ZodString, ZodType } from "zod";
 import { downloadAndExtract } from "../utils/download.js";
 import { loadAIGNE } from "../utils/load-aigne.js";
 import { runAgentWithAIGNE, stdinHasData } from "../utils/run-with-aigne.js";
@@ -19,7 +19,7 @@ const NPM_PACKAGE_CACHE_TIME_MS = 1000 * 60 * 60 * 24; // 1 day
 const builtinApps = [
     {
         name: "doc-smith",
-        describe: "Generate professional documents by doc-smith",
+        describe: "Generate and maintain project docs — powered by agents.",
         aliases: ["docsmith", "doc"],
     },
 ];
@@ -92,9 +92,14 @@ const agentCommandModule = ({ dir, agent, }) => {
         describe: agent.description || "",
         builder: (yargs) => {
             for (const [option, config] of Object.entries(inputSchema)) {
+                const innerType = innerZodType(config);
                 yargs.option(option, {
                     // TODO: support more types
-                    type: "string",
+                    type: innerType instanceof ZodBoolean
+                        ? "boolean"
+                        : innerType instanceof ZodNumber
+                            ? "number"
+                            : "string",
                     description: config.description,
                 });
                 if (!(config.isNullable() || config.isOptional())) {
@@ -118,6 +123,12 @@ const agentCommandModule = ({ dir, agent, }) => {
         },
     };
 };
+function innerZodType(type) {
+    if ("innerType" in type._def && type._def.innerType instanceof ZodType) {
+        return innerZodType(type._def.innerType);
+    }
+    return type;
+}
 export async function invokeCLIAgentFromDir(options) {
     const aigne = await loadAIGNE(options.dir, { model: options.input.model });
     try {

package/dist/commands/connect.js

@@ -3,7 +3,7 @@ import { readFile } from "node:fs/promises";
 import chalk from "chalk";
 import { parse } from "yaml";
 import { getUserInfo } from "../utils/aigne-hub-user.js";
-import { AIGNE_ENV_FILE, connectToAIGNEHub } from "../utils/load-aigne.js";
+import { AIGNE_ENV_FILE, connectToAIGNEHub, DEFAULT_URL } from "../utils/load-aigne.js";
 const formatNumber = (balance) => {
     const balanceNum = String(balance).split(".")[0];
     return chalk.yellow((balanceNum || "").replace(/\B(?=(\d{3})+(?!\d))/g, ","));
@@ -36,16 +36,15 @@ export async function displayStatus(statusList) {
         return;
     }
     console.log(chalk.blue("AIGNE Hub Connection Status:\n"));
-    for (const status of statusList) {
-        const userInfo = await getUserInfo({
-            baseUrl: status.apiUrl,
-            accessKey: status.apiKey,
-        }).catch((e) => {
+    const defaultStatus = statusList.find((status) => status.host === "default")?.apiUrl || DEFAULT_URL;
+    for (const status of statusList.filter((status) => status.host !== "default")) {
+        const userInfo = await getUserInfo({ baseUrl: status.apiUrl, apiKey: status.apiKey }).catch((e) => {
             console.error(e);
             return null;
         });
-        const statusIcon = userInfo ? chalk.green("✓") : chalk.red("✗");
-        const statusText = userInfo ? "Connected" : "Disconnected";
+        const isConnected = new URL(status.apiUrl).origin === new URL(defaultStatus).origin;
+        const statusIcon = isConnected ? chalk.green("✓") : chalk.red("✗");
+        const statusText = isConnected ? "Connected" : "Disconnected";
         console.log(`${statusIcon} ${chalk.bold(status.host)}`);
         console.log(`   Status: ${statusText}`);
         if (userInfo) {

package/dist/commands/run.js

@@ -5,7 +5,7 @@ import { isAbsolute, join, resolve } from "node:path";
 import { logger } from "@aigne/core/utils/logger.js";
 import { isNonNullable } from "@aigne/core/utils/type-utils.js";
 import { Listr, PRESET_TIMER } from "@aigne/listr2";
-import { select } from "@inquirer/prompts";
+import { input as inputInquirer, select as selectInquirer } from "@inquirer/prompts";
 import { ListrInquirerPromptAdapter } from "@listr2/prompt-adapter-inquirer";
 import { config } from "dotenv-flow";
 import { isV1Package, toAIGNEPackage } from "../utils/agent-v1.js";
@@ -31,6 +31,10 @@ export function createRunCommand({ aigneFilePath, } = {}) {
                 .option("cache-dir", {
                 describe: "Directory to download the package to (defaults to the ~/.aigne/xxx)",
                 type: "string",
+            })
+                .option("aigne-hub-url", {
+                describe: "Custom AIGNE Hub service URL. Used to fetch remote agent definitions or models. ",
+                type: "string",
             })
                 .strict(false);
         },
@@ -63,11 +67,21 @@ export function createRunCommand({ aigneFilePath, } = {}) {
                     task: async (ctx, task) => {
                         // Load env files in the aigne directory
                         config({ path: dir, silent: true });
-                        const aigne = await loadAIGNE(dir, { ...options, model: options.model || process.env.MODEL }, {
+                        const aigne = await loadAIGNE(dir, {
+                            ...options,
+                            model: options.model || process.env.MODEL,
+                            aigneHubUrl: options?.aigneHubUrl,
+                        }, {
                             inquirerPromptFn: (prompt) => {
+                                if (prompt.type === "input") {
+                                    return task
+                                        .prompt(ListrInquirerPromptAdapter)
+                                        .run(inputInquirer, prompt)
+                                        .then((res) => ({ [prompt.name]: res }));
+                                }
                                 return task
                                     .prompt(ListrInquirerPromptAdapter)
-                                    .run(select, prompt)
+                                    .run(selectInquirer, prompt)
                                     .then((res) => ({ [prompt.name]: res }));
                             },
                         });

package/dist/commands/serve-mcp.d.ts

@@ -14,5 +14,6 @@ export declare function serveMCPServerFromDir(options: {
     host: string;
     port?: number;
     pathname: string;
+    aigneHubUrl?: string;
 }): Promise<void>;
 export {};

package/dist/commands/serve-mcp.js

@@ -36,6 +36,10 @@ export function createServeMCPCommand({ aigneFilePath, } = {}) {
                 describe: "Pathname to the service",
                 type: "string",
                 default: "/mcp",
+            })
+                .option("aigne-hub-url", {
+                describe: "Custom AIGNE Hub service URL. Used to fetch remote agent definitions or models. ",
+                type: "string",
             });
         },
         handler: async (options) => {
@@ -47,7 +51,7 @@ export function createServeMCPCommand({ aigneFilePath, } = {}) {
 }
 export async function serveMCPServerFromDir(options) {
     const port = options.port || DEFAULT_PORT();
-    const aigne = await loadAIGNE(options.dir);
+    const aigne = await loadAIGNE(options.dir, { aigneHubUrl: options.aigneHubUrl });
     await serveMCPServer({
         aigne,
         host: options.host,

package/dist/commands/test.d.ts

@@ -1,6 +1,7 @@
 import type { CommandModule } from "yargs";
 interface TestOptions {
     path: string;
+    aigneHubUrl?: string;
 }
 export declare function createTestCommand({ aigneFilePath, }?: {
     aigneFilePath?: string;

package/dist/commands/test.js

@@ -7,17 +7,22 @@ export function createTestCommand({ aigneFilePath, } = {}) {
         command: "test",
         describe: "Run tests in the specified agents directory",
         builder: (yargs) => {
-            return yargs.option("path", {
+            return yargs
+                .option("path", {
                 describe: "Path to the agents directory or URL to aigne project",
                 type: "string",
                 default: ".",
                 alias: ["url"],
+            })
+                .option("aigne-hub-url", {
+                describe: "Custom AIGNE Hub service URL. Used to fetch remote agent definitions or models. ",
+                type: "string",
             });
         },
         handler: async (options) => {
             const path = aigneFilePath || options.path;
             const absolutePath = isAbsolute(path) ? path : resolve(process.cwd(), path);
-            const aigne = await loadAIGNE(absolutePath);
+            const aigne = await loadAIGNE(absolutePath, { aigneHubUrl: options?.aigneHubUrl });
             assert(aigne.rootDir);
             spawnSync("node", ["--test"], { cwd: aigne.rootDir, stdio: "inherit" });
         },

package/dist/utils/aigne-hub-user.d.ts

@@ -10,7 +10,7 @@ export interface UserInfoResult {
     paymentLink: string | null;
     profileLink: string;
 }
-export declare function getUserInfo({ baseUrl, accessKey, }: {
+export declare function getUserInfo({ baseUrl, apiKey, }: {
     baseUrl: string;
-    accessKey: string;
+    apiKey: string;
 }): Promise<UserInfoResult>;

package/dist/utils/aigne-hub-user.js

@@ -1,8 +1,8 @@
 import { joinURL } from "ufo";
-export async function getUserInfo({ baseUrl, accessKey, }) {
+export async function getUserInfo({ baseUrl, apiKey, }) {
     const response = await fetch(joinURL(baseUrl, "/api/user/info"), {
         headers: {
-            Authorization: `Bearer ${accessKey}`,
+            Authorization: `Bearer ${apiKey}`,
         },
     });
     if (!response.ok)

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

@@ -11,6 +11,7 @@ export interface RunOptions extends RunAIGNECommandOptions {
     path: string;
     entryAgent?: string;
     cacheDir?: string;
+    aigneHubUrl?: string;
 }
 type FetchResult = {
     accessKeyId: string;
@@ -42,19 +43,20 @@ interface CreateConnectOptions {
     }) => Promise<FetchResult>;
 }
 export declare function createConnect({ connectUrl, openPage, fetchInterval, retry, source, connectAction, wrapSpinner, closeOnSuccess, intervalFetchConfig, appName, appLogo, }: CreateConnectOptions): Promise<FetchResult>;
+export declare const DEFAULT_URL = "https://hub.aigne.io/";
 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;
+    apiKey: string;
     url: string;
 } | {
-    accessKey: undefined;
+    apiKey: undefined;
     url: undefined;
 }>;
 export declare const checkConnectionStatus: (host: string) => Promise<{
     apiKey: any;
     url: string;
 }>;
-export declare function loadAIGNE(path: string, options?: Pick<RunOptions, "model">, actionOptions?: {
+export declare function loadAIGNE(path: string, options?: Pick<RunOptions, "model" | "aigneHubUrl">, actionOptions?: {
     inquirerPromptFn?: (prompt: {
         type: string;
         name: string;

package/dist/utils/load-aigne.js

@@ -93,7 +93,7 @@ export async function createConnect({ connectUrl, openPage, fetchInterval = 3 *
 const AGENT_HUB_PROVIDER = "aignehub";
 const DEFAULT_AIGNE_HUB_MODEL = "openai/gpt-4o";
 const DEFAULT_AIGNE_HUB_PROVIDER_MODEL = `${AGENT_HUB_PROVIDER}:${DEFAULT_AIGNE_HUB_MODEL}`;
-const DEFAULT_URL = "https://hub.aigne.io/";
+export const DEFAULT_URL = "https://hub.aigne.io/";
 export const formatModelName = async (models, model, inquirerPrompt) => {
     if (!model)
         return DEFAULT_AIGNE_HUB_PROVIDER_MODEL;
@@ -151,7 +151,7 @@ export async function connectToAIGNEHub(url) {
             openPage: (pageUrl) => open(pageUrl),
         });
         const accessKeyOptions = {
-            accessKey: result.accessKeySecret,
+            apiKey: result.accessKeySecret,
             url: joinURL(origin, aigneHubMount?.mountPoint || ""),
         };
         // After redirection, write the AIGNE Hub access token
@@ -163,7 +163,10 @@ export async function connectToAIGNEHub(url) {
         await writeFile(AIGNE_ENV_FILE, stringify({
             ...envs,
             [host]: {
-                AIGNE_HUB_API_KEY: accessKeyOptions.accessKey,
+                AIGNE_HUB_API_KEY: accessKeyOptions.apiKey,
+                AIGNE_HUB_API_URL: accessKeyOptions.url,
+            },
+            default: {
                 AIGNE_HUB_API_URL: accessKeyOptions.url,
             },
         })).catch((err) => {
@@ -174,7 +177,7 @@ export async function connectToAIGNEHub(url) {
     }
     catch (error) {
         logger.error("Failed to connect to AIGNE Hub", error.message);
-        return { accessKey: undefined, url: undefined };
+        return { apiKey: undefined, url: undefined };
     }
 }
 export const checkConnectionStatus = async (host) => {
@@ -201,11 +204,17 @@ export const checkConnectionStatus = async (host) => {
 };
 const mockInquirerPrompt = (() => Promise.resolve({ useAigneHub: true }));
 export async function loadAIGNE(path, options, actionOptions) {
-    const models = availableModels();
-    const AIGNE_HUB_URL = process.env.AIGNE_HUB_API_URL || DEFAULT_URL;
-    const connectUrl = joinURL(new URL(AIGNE_HUB_URL).origin, WELLKNOWN_SERVICE_PATH_PREFIX);
+    const aigneDir = join(homedir(), ".aigne");
+    if (!existsSync(aigneDir)) {
+        mkdirSync(aigneDir, { recursive: true });
+    }
+    const envs = parse(await readFile(AIGNE_ENV_FILE, "utf8").catch(() => stringify({})));
     const inquirerPrompt = (actionOptions?.inquirerPromptFn ??
         inquirer.prompt);
+    const models = availableModels();
+    const configUrl = options?.aigneHubUrl || process.env.AIGNE_HUB_API_URL;
+    const AIGNE_HUB_URL = configUrl || envs?.default?.AIGNE_HUB_API_URL || DEFAULT_URL;
+    const connectUrl = joinURL(new URL(AIGNE_HUB_URL).origin, WELLKNOWN_SERVICE_PATH_PREFIX);
     const { host } = new URL(AIGNE_HUB_URL);
     const { aigne } = await loadAIGNEFile(path).catch(() => ({ aigne: null }));
     const result = await checkConnectionStatus(host).catch(() => null);
@@ -222,25 +231,55 @@ export async function loadAIGNE(path, options, actionOptions) {
         }
         catch (error) {
             if (error instanceof Error && error.message.includes("login first")) {
-                // If none or invalid, prompt the user to proceed
-                const subscribePrompt = await inquirerPrompt({
-                    type: "list",
-                    name: "subscribe",
-                    message: "No LLM API Keys or AIGNE Hub connections found, select your preferred way to continue:",
-                    choices: [
-                        {
-                            name: "Connect to AIGNE Hub with just a few clicks, free credits eligible for new users (Recommended)",
-                            value: true,
-                        },
-                        { name: "Exit and configure my own LLM API Keys", value: false },
-                    ],
-                    default: true,
-                });
-                if (!subscribePrompt.subscribe) {
-                    console.warn("The AIGNE Hub connection has been cancelled");
-                    process.exit(0);
+                let aigneHubUrl = connectUrl;
+                if (!configUrl) {
+                    const { subscribe } = await inquirerPrompt({
+                        type: "list",
+                        name: "subscribe",
+                        message: "No LLM API Keys or AIGNE Hub connections found. How would you like to proceed?",
+                        choices: [
+                            {
+                                name: "Connect to the Arcblock official AIGNE Hub (recommended, free credits for new users)",
+                                value: "official",
+                            },
+                            connectUrl.includes(DEFAULT_URL)
+                                ? {
+                                    name: "Connect to your own AIGNE Hub instance (self-hosted)",
+                                    value: "custom",
+                                }
+                                : null,
+                            {
+                                name: "Exit and configure my own LLM API Keys",
+                                value: "manual",
+                            },
+                        ].filter(Boolean),
+                        default: "official",
+                    });
+                    if (subscribe === "custom") {
+                        const { customUrl } = await inquirerPrompt({
+                            type: "input",
+                            name: "customUrl",
+                            message: "Enter the URL of your AIGNE Hub:",
+                            validate(input) {
+                                try {
+                                    const url = new URL(input);
+                                    return url.protocol.startsWith("http")
+                                        ? true
+                                        : "Must be a valid URL with http or https";
+                                }
+                                catch {
+                                    return "Invalid URL";
+                                }
+                            },
+                        });
+                        aigneHubUrl = customUrl;
+                    }
+                    else if (subscribe === "manual") {
+                        console.log("You chose to configure your own LLM API Keys. Exiting...");
+                        process.exit(0);
+                    }
                 }
-                credential = await connectToAIGNEHub(connectUrl);
+                credential = await connectToAIGNEHub(aigneHubUrl);
             }
         }
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aigne/cli",
-  "version": "1.31.0",
-  "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",
+  "version": "1.32.1",
+  "description": "Your command center for agent development",
   "publishConfig": {
     "access": "public"
   },
@@ -74,13 +74,13 @@
     "yaml": "^2.8.0",
     "yargs": "^18.0.0",
     "zod": "^3.25.67",
-    "@aigne/agent-library": "^1.21.14",
-    "@aigne/agentic-memory": "^1.0.14",
-    "@aigne/aigne-hub": "^0.4.5",
-    "@aigne/core": "^1.46.0",
-    "@aigne/default-memory": "^1.0.14",
+    "@aigne/agentic-memory": "^1.0.15",
+    "@aigne/agent-library": "^1.21.15",
+    "@aigne/core": "^1.46.1",
+    "@aigne/aigne-hub": "^0.4.6",
+    "@aigne/default-memory": "^1.0.15",
     "@aigne/observability-api": "^0.9.0",
-    "@aigne/openai": "^0.10.14"
+    "@aigne/openai": "^0.10.15"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",