@aigne/cli 1.45.0 → 1.46.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [1.46.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.45.0...cli-v1.46.0) (2025-09-10)
+
+
+### Features
+
+* support custom model for every agents ([#472](https://github.com/AIGNE-io/aigne-framework/issues/472)) ([0bda78a](https://github.com/AIGNE-io/aigne-framework/commit/0bda78a2ebf537e953d855882d68cb37d94d1d10))
+
+
+### Bug Fixes
+
+* **cli:** load AIGNE in a child process to ensure app is available ([#475](https://github.com/AIGNE-io/aigne-framework/issues/475)) ([c8201b5](https://github.com/AIGNE-io/aigne-framework/commit/c8201b51accc4a9d047394f235df53725733f726))
+* **cli:** run default agent if `entry-agent` argument not present ([#473](https://github.com/AIGNE-io/aigne-framework/issues/473)) ([8c46672](https://github.com/AIGNE-io/aigne-framework/commit/8c4667206a2336e74db07442dc296ef9f9265a0b))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.21.42
+    * @aigne/agentic-memory bumped to 1.0.42
+    * @aigne/aigne-hub bumped to 0.9.1
+    * @aigne/core bumped to 1.60.0
+    * @aigne/default-memory bumped to 1.2.5
+    * @aigne/observability-api bumped to 0.10.3
+    * @aigne/openai bumped to 0.15.1
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.49
+
 ## [1.45.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.44.3...cli-v1.45.0) (2025-09-09)
 
 

package/dist/commands/app.d.ts

@@ -1,4 +1,4 @@
-import { type Agent, AIGNE, type Message } from "@aigne/core";
+import type { Agent, AIGNE, Message } from "@aigne/core";
 import type { CommandModule } from "yargs";
 import { type AgentRunCommonOptions } from "../utils/yargs.js";
 export declare function createAppCommands(): CommandModule[];

package/dist/commands/app.js

@@ -3,13 +3,13 @@ import { spawn } from "node:child_process";
 import { mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { AIGNE } from "@aigne/core";
 import { logger } from "@aigne/core/utils/logger.js";
 import { Listr, PRESET_TIMER } from "@aigne/listr2";
 import { joinURL } from "ufo";
 import { downloadAndExtract } from "../utils/download.js";
 import { loadAIGNE } from "../utils/load-aigne.js";
 import { runAgentWithAIGNE } from "../utils/run-with-aigne.js";
+import { safeLoadAIGNE } from "../utils/workers/load-aigne.js";
 import { parseAgentInput, withAgentInputSchema, } from "../utils/yargs.js";
 import { serveMCPServerFromDir } from "./serve-mcp.js";
 const NPM_PACKAGE_CACHE_TIME_MS = 1000 * 60 * 60 * 24; // 1 day
@@ -94,6 +94,7 @@ export const agentCommandModule = ({ dir, agent, }) => {
             if (options.logLevel)
                 logger.level = options.logLevel;
             await invokeCLIAgentFromDir({ dir, agent: agent.name, input: options });
+            process.exit(0);
         },
     };
 };
@@ -127,7 +128,7 @@ export async function loadApplication({ name, dir, forceUpgrade = false, }) {
     dir ??= join(homedir(), ".aigne", "registry.npmjs.org", name);
     let check = forceUpgrade ? undefined : await isInstallationAvailable(dir);
     if (check?.available) {
-        const aigne = await AIGNE.load(dir).catch((error) => {
+        const aigne = await safeLoadAIGNE(dir).catch((error) => {
             console.warn(`⚠️ Failed to load ${name}, trying to reinstall:`, error.message);
         });
         if (aigne) {
@@ -177,7 +178,7 @@ export async function loadApplication({ name, dir, forceUpgrade = false, }) {
         },
     }).run();
     return {
-        aigne: await AIGNE.load(dir),
+        aigne: await safeLoadAIGNE(dir),
         dir,
         version: result.version,
     };

package/dist/commands/run.d.ts

@@ -3,4 +3,5 @@ export declare function createRunCommand({ aigneFilePath, }?: {
     aigneFilePath?: string;
 }): CommandModule<unknown, {
     path?: string;
+    entryAgent?: string;
 }>;

package/dist/commands/run.js

@@ -1,6 +1,7 @@
 import { cp, mkdir, rm } from "node:fs/promises";
 import { homedir } from "node:os";
 import { isAbsolute, join, resolve } from "node:path";
+import { exists } from "@aigne/agent-library/utils/fs.js";
 import { flat, isNonNullable } from "@aigne/core/utils/type-utils.js";
 import { Listr, PRESET_TIMER } from "@aigne/listr2";
 import { config } from "dotenv-flow";
@@ -8,10 +9,11 @@ import yargs from "yargs";
 import { isV1Package, toAIGNEPackage } from "../utils/agent-v1.js";
 import { downloadAndExtract } from "../utils/download.js";
 import { loadAIGNE } from "../utils/load-aigne.js";
+import { isUrl } from "../utils/url.js";
 import { agentCommandModule } from "./app.js";
 export function createRunCommand({ aigneFilePath, } = {}) {
     return {
-        command: "run [path]",
+        command: "run [path] [entry-agent]",
         describe: "Run AIGNE for the specified path",
         builder: async (yargs) => {
             return yargs
@@ -19,16 +21,23 @@ export function createRunCommand({ aigneFilePath, } = {}) {
                 type: "string",
                 describe: "Path to the agents directory or URL to an aigne project",
                 default: ".",
+            })
+                .positional("entry-agent", {
+                type: "string",
+                describe: "Name of the agent to run (defaults to the entry agent if not specified)",
             })
                 .help(false)
                 .version(false)
                 .strict(false);
         },
         handler: async (options) => {
-            const p = aigneFilePath || options.path;
-            if (!p)
-                throw new Error("No path specified");
-            const { aigne, path } = await loadApplication(p);
+            if (!options.entryAgent && options.path) {
+                if (!(await exists(options.path)) && !isUrl(options.path)) {
+                    options.entryAgent = options.path;
+                    options.path = undefined;
+                }
+            }
+            const { aigne, path } = await loadApplication(aigneFilePath || options.path || ".");
             const subYargs = yargs().scriptName("").usage("aigne run <path> <agent> [...options]");
             if (aigne.cli.chat) {
                 subYargs.command({
@@ -37,7 +46,8 @@ export function createRunCommand({ aigneFilePath, } = {}) {
                 });
             }
             // Allow user to run all of agents in the AIGNE instances
-            for (const agent of flat(aigne.cli.agents, aigne.agents, aigne.skills, aigne.cli.chat, aigne.mcpServer.agents)) {
+            const allAgents = flat(aigne.cli.agents, aigne.agents, aigne.skills, aigne.cli.chat, aigne.mcpServer.agents);
+            for (const agent of allAgents) {
                 subYargs.command(agentCommandModule({ dir: path, agent }));
             }
             const argv = process.argv.slice(aigneFilePath ? 3 : 2);
@@ -50,6 +60,9 @@ export function createRunCommand({ aigneFilePath, } = {}) {
                 argv.shift(); // remove path/url args
             if (argv[0] === "--entry-agent")
                 argv.shift();
+            const firstAgent = aigne.agents[0]?.name;
+            if (!options.entryAgent && firstAgent)
+                argv.unshift(firstAgent);
             await subYargs
                 .strict()
                 .demandCommand()

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

@@ -12,7 +12,8 @@ export function maskApiKey(apiKey) {
     return `${start}${"*".repeat(8)}${end}`;
 }
 export const parseModelOption = (model) => {
-    const { provider, name } = model.match(/(?<provider>[^:]*)(:(?<name>.*))?/)?.groups ?? {};
+    model = model.replace(":", "/");
+    const { provider, name } = model.match(/(?<provider>[^/]*)(\/(?<name>.*))?/)?.groups ?? {};
     return { provider: provider?.replace(/-/g, ""), model: name };
 };
 export const formatModelName = async (model, inquirerPrompt) => {

package/dist/utils/url.d.ts

@@ -0,0 +1 @@
+export declare function isUrl(s: string): boolean;

package/dist/utils/url.js

@@ -0,0 +1,3 @@
+export function isUrl(s) {
+    return /^https?:\/\/\S+/.test(s);
+}

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

@@ -0,0 +1 @@
+export {};

package/dist/utils/workers/load-aigne-worker.js

@@ -0,0 +1,13 @@
+import { AIGNE } from "@aigne/core";
+process.on("message", async ({ method, args }) => {
+    try {
+        if (method !== "AIGNE.load")
+            throw new Error(`Unknown method: ${method}`);
+        await AIGNE.load(...args);
+        process.send?.({ method, status: "success" });
+    }
+    catch (error) {
+        process.send?.({ method, status: "error", message: error.message });
+    }
+    process.exit(0);
+});

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

@@ -0,0 +1,2 @@
+import { AIGNE } from "@aigne/core";
+export declare function safeLoadAIGNE(...args: Parameters<typeof AIGNE.load>): Promise<ReturnType<typeof AIGNE.load>>;

package/dist/utils/workers/load-aigne.js

@@ -0,0 +1,24 @@
+import { fork } from "node:child_process";
+import { join } from "node:path";
+import { AIGNE } from "@aigne/core";
+export async function safeLoadAIGNE(...args) {
+    await new Promise((resolve, reject) => {
+        const child = fork(join(import.meta.dirname, "./load-aigne-worker.js"), { timeout: 600e3 });
+        child.on("message", ({ method, message, status }) => {
+            if (method !== "AIGNE.load")
+                reject(new Error(`Unknown method: ${method}`));
+            else if (status === "error")
+                reject(new Error(`Failed to load AIGNE: ${message}`));
+            else if (status === "success")
+                resolve();
+        });
+        child.on("exit", (code) => {
+            if (code !== 0)
+                reject(new Error(`Child process exited with code ${code}`));
+            else
+                resolve();
+        });
+        child.send({ method: "AIGNE.load", args });
+    });
+    return AIGNE.load(...args);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.45.0",
+  "version": "1.46.0",
   "description": "Your command center for agent development",
   "publishConfig": {
     "access": "public"
@@ -81,13 +81,13 @@
     "yargs": "^18.0.0",
     "yoctocolors-cjs": "^2.1.3",
     "zod": "^3.25.67",
-    "@aigne/agentic-memory": "^1.0.41",
-    "@aigne/core": "^1.59.0",
-    "@aigne/agent-library": "^1.21.41",
-    "@aigne/aigne-hub": "^0.9.0",
-    "@aigne/default-memory": "^1.2.4",
-    "@aigne/openai": "^0.15.0",
-    "@aigne/observability-api": "^0.10.2"
+    "@aigne/agentic-memory": "^1.0.42",
+    "@aigne/core": "^1.60.0",
+    "@aigne/default-memory": "^1.2.5",
+    "@aigne/agent-library": "^1.21.42",
+    "@aigne/aigne-hub": "^0.9.1",
+    "@aigne/openai": "^0.15.1",
+    "@aigne/observability-api": "^0.10.3"
   },
   "devDependencies": {
     "@inquirer/testing": "^2.1.49",
@@ -104,7 +104,7 @@
     "rimraf": "^6.0.1",
     "typescript": "^5.8.3",
     "ufo": "^1.6.1",
-    "@aigne/test-utils": "^0.5.48"
+    "@aigne/test-utils": "^0.5.49"
   },
   "scripts": {
     "lint": "tsc --noEmit",

package/templates/default/README.md

@@ -30,7 +30,27 @@ OPENAI_API_KEY="YOUR_OPENAI_API_KEY"
 ### Start the Project
 
 ```bash
-aigne run
+aigne run --input "Hello, what can you help me with?"
+```
+
+use the following command to pipe input from the terminal:
+
+```bash
+echo "Hello, what can you help me with?" | aigne run
+```
+
+use the following command to start an interactive chat session:
+
+```bash
+aigne run --chat
+```
+
+help:
+
+```bash
+aigne run -h # show help of project
+
+aigne run chat -h # show help of agent
 ```
 
 ## Testing