@aigne/cli 1.30.3 → 1.31.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## [1.31.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.30.4...cli-v1.31.0) (2025-08-06)
+
+
+### Features
+
+* **cli:** support custom task title of agent in cli ([#328](https://github.com/AIGNE-io/aigne-framework/issues/328)) ([128d75f](https://github.com/AIGNE-io/aigne-framework/commit/128d75fb42ca470b47a2793d79c92d7bb64cfedb))
+
+
+### Bug Fixes
+
+* **cli:** nunjucks should import as cjs module ([432b9e1](https://github.com/AIGNE-io/aigne-framework/commit/432b9e1e436bd5b02427a5effea907be1f589c31))
+* **core:** improve hook handling in agent and context ([#325](https://github.com/AIGNE-io/aigne-framework/issues/325)) ([c858fec](https://github.com/AIGNE-io/aigne-framework/commit/c858fecb08453c2daca9708f4b8a9c135fac40b0))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.21.14
+    * @aigne/agentic-memory bumped to 1.0.14
+    * @aigne/aigne-hub bumped to 0.4.5
+    * @aigne/core bumped to 1.46.0
+    * @aigne/default-memory bumped to 1.0.14
+    * @aigne/openai bumped to 0.10.14
+
+## [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)
 
 

package/dist/cli.js

@@ -17,7 +17,13 @@ function getAIGNEFilePath() {
 }
 const aigneFilePath = getAIGNEFilePath();
 export default createAIGNECommand({ aigneFilePath })
-    .fail(() => { })
+    .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,6 +23,7 @@ export function createAIGNECommand(options) {
         .command(createObservabilityCommand())
         .command(createConnectCommand())
         .command(createAppCommands())
+        .demandCommand()
         .alias("help", "h")
         .alias("version", "v")
         .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.d.ts

@@ -20,10 +20,11 @@ export declare class TerminalTracer {
         [key: string]: string;
     }): string;
     formatTimeUsage(startTime: number, endTime: number): string;
-    formatTaskTitle(agent: Agent, { task, usage, time }?: {
+    formatTaskTitle(agent: Agent, { task, usage, time, input }: {
         task?: Task;
         usage?: boolean;
         time?: boolean;
+        input: Message;
     }): string;
     private marked;
     get outputKey(): string;

package/dist/tracer/terminal.js

@@ -1,6 +1,6 @@
 import { EOL } from "node:os";
 import { inspect } from "node:util";
-import { AIAgent, ChatModel, DEFAULT_OUTPUT_KEY, } from "@aigne/core";
+import { AIAgent, ChatModel, DEFAULT_OUTPUT_KEY, UserAgent, } from "@aigne/core";
 import { LogLevel, logger } from "@aigne/core/utils/logger.js";
 import { promiseWithResolvers } from "@aigne/core/utils/promise.js";
 import { flat, omit } from "@aigne/core/utils/type-utils.js";
@@ -9,6 +9,7 @@ import { markedTerminal } from "@aigne/marked-terminal";
 import * as prompts from "@inquirer/prompts";
 import chalk from "chalk";
 import { Marked } from "marked";
+import nunjucks from "nunjucks";
 import { AIGNEListr, AIGNEListrRenderer } from "../utils/listr.js";
 import { parseDuration } from "../utils/time.js";
 export class TerminalTracer {
@@ -28,7 +29,9 @@ export class TerminalTracer {
                 : undefined,
             formatResult: (result, options) => [this.formatResult(agent, context, result, options)].filter(Boolean),
         }, [], { concurrent: true });
-        const onStart = async ({ context, agent }) => {
+        const onStart = async ({ context, agent, ...event }) => {
+            if (agent instanceof UserAgent)
+                return;
             const contextId = context.id;
             const parentContextId = context.parentId;
             const task = {
@@ -38,7 +41,7 @@ export class TerminalTracer {
             };
             this.tasks[contextId] = task;
             const listrTask = {
-                title: this.formatTaskTitle(agent),
+                title: this.formatTaskTitle(agent, { ...event }),
                 task: (ctx, taskWrapper) => {
                     const subtask = taskWrapper.newListr([{ task: () => task.promise }]);
                     task.listr.resolve({ subtask, taskWrapper, ctx });
@@ -82,7 +85,7 @@ export class TerminalTracer {
                 },
             };
         };
-        const onSuccess = async ({ context, agent, output }) => {
+        const onSuccess = async ({ context, agent, output, ...event }) => {
             const contextId = context.id;
             const parentContextId = context.parentId;
             const task = this.tasks[contextId];
@@ -97,20 +100,20 @@ export class TerminalTracer {
                 if (model)
                     task.extraTitleMetadata.model = model;
             }
-            taskWrapper.title = this.formatTaskTitle(agent, { task, usage: true, time: true });
+            taskWrapper.title = this.formatTaskTitle(agent, { ...event, task, usage: true, time: true });
             if (!parentContextId || !this.tasks[parentContextId]) {
                 Object.assign(ctx, output);
             }
             task.resolve();
         };
-        const onError = async ({ context, agent, error }) => {
+        const onError = async ({ context, agent, error, ...event }) => {
             const contextId = context.id;
             const task = this.tasks[contextId];
             if (!task)
                 return;
             task.endTime = Date.now();
             const { taskWrapper } = await task.listr.promise;
-            taskWrapper.title = this.formatTaskTitle(agent, { task, usage: true, time: true });
+            taskWrapper.title = this.formatTaskTitle(agent, { ...event, task, usage: true, time: true });
             task.reject(error);
         };
         const result = await listr.run(() => context.invoke(agent, input, {
@@ -143,8 +146,11 @@ export class TerminalTracer {
         const duration = endTime - startTime;
         return chalk.grey(`[${parseDuration(duration)}]`);
     }
-    formatTaskTitle(agent, { task, usage, time } = {}) {
-        let title = `invoke agent ${agent.name}`;
+    formatTaskTitle(agent, { task, usage, time, input }) {
+        let title = agent.name;
+        if (agent.taskTitle) {
+            title += ` ${chalk.cyan(nunjucks.renderString(agent.taskTitle, { ...input }))}`;
+        }
         if (usage && task?.usage)
             title += ` ${this.formatTokenUsage(task.usage, task.extraTitleMetadata)}`;
         if (time && task?.startTime && task.endTime)

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.3",
+  "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",
   "publishConfig": {
     "access": "public"
@@ -64,6 +64,7 @@
     "inquirer": "^12.7.0",
     "log-update": "^6.1.0",
     "marked": "^16.0.0",
+    "nunjucks": "^3.2.4",
     "open": "10.1.2",
     "openai": "^5.8.3",
     "p-wait-for": "^5.0.2",
@@ -73,13 +74,13 @@
     "yaml": "^2.8.0",
     "yargs": "^18.0.0",
     "zod": "^3.25.67",
-    "@aigne/agent-library": "^1.21.12",
-    "@aigne/aigne-hub": "^0.4.3",
-    "@aigne/core": "^1.44.0",
-    "@aigne/default-memory": "^1.0.12",
+    "@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/observability-api": "^0.9.0",
-    "@aigne/agentic-memory": "^1.0.12",
-    "@aigne/openai": "^0.10.12"
+    "@aigne/openai": "^0.10.14"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",
@@ -88,6 +89,7 @@
     "@types/glob": "^9.0.0",
     "@types/gradient-string": "^1.1.6",
     "@types/node": "^24.0.12",
+    "@types/nunjucks": "^3.2.6",
     "@types/yargs": "^17.0.33",
     "archiver": "^7.0.1",
     "hono": "4.8.4",