@aigne/cli 1.59.0-beta.11 → 1.59.0-beta.13

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # Changelog
 
+## [1.59.0-beta.13](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.12...cli-v1.59.0-beta.13) (2026-01-06)
+
+
+### Features
+
+* **core:** add cross session user memory support ([#873](https://github.com/AIGNE-io/aigne-framework/issues/873)) ([f377aa1](https://github.com/AIGNE-io/aigne-framework/commit/f377aa17f2cf8004fd3225ade4a37fd90af1292f))
+
+
+### Bug Fixes
+
+* **cli:** add askUserQuestion for run-skill command ([9c621e7](https://github.com/AIGNE-io/aigne-framework/commit/9c621e7c55501d129e71966da79514717a4579ab))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-history bumped to 1.2.0-beta.6
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.10
+    * @aigne/agent-library bumped to 1.24.0-beta.12
+    * @aigne/agentic-memory bumped to 1.1.6-beta.10
+    * @aigne/aigne-hub bumped to 0.10.16-beta.14
+    * @aigne/core bumped to 1.72.0-beta.10
+    * @aigne/default-memory bumped to 1.4.0-beta.9
+    * @aigne/openai bumped to 0.16.16-beta.10
+    * @aigne/secrets bumped to 0.1.6-beta.10
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.10
+
+## [1.59.0-beta.12](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.11...cli-v1.59.0-beta.12) (2026-01-02)
+
+
+### Features
+
+* **cli:** add run-skill command ([#868](https://github.com/AIGNE-io/aigne-framework/issues/868)) ([f62ffe2](https://github.com/AIGNE-io/aigne-framework/commit/f62ffe21acc49ec1a68349fbb35a13d0fadd239a))
+
+
+### Bug Fixes
+
+* **cli:** add chat aliases for interactive option ([#867](https://github.com/AIGNE-io/aigne-framework/issues/867)) ([91f27fd](https://github.com/AIGNE-io/aigne-framework/commit/91f27fd874b8c4b2ded2d7cd46e2821f70943c69))
+* **cli:** rename cmd option --chat to --interactive ([#865](https://github.com/AIGNE-io/aigne-framework/issues/865)) ([480eca4](https://github.com/AIGNE-io/aigne-framework/commit/480eca49a7381a330024f1f0026bbc5f89b57bbb))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.9
+    * @aigne/agent-library bumped to 1.24.0-beta.11
+    * @aigne/agentic-memory bumped to 1.1.6-beta.9
+    * @aigne/aigne-hub bumped to 0.10.16-beta.13
+    * @aigne/core bumped to 1.72.0-beta.9
+    * @aigne/default-memory bumped to 1.4.0-beta.8
+    * @aigne/openai bumped to 0.16.16-beta.9
+    * @aigne/secrets bumped to 0.1.6-beta.9
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.9
+
 ## [1.59.0-beta.11](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.10...cli-v1.59.0-beta.11) (2025-12-31)
 
 

package/dist/commands/aigne.js

@@ -8,6 +8,7 @@ import { createEvalCommand } from "./eval.js";
 import { createHubCommand } from "./hub.js";
 import { createObservabilityCommand } from "./observe.js";
 import { createRunCommand } from "./run.js";
+import { createRunSkillCommand } from "./run-skill.js";
 import { createServeMCPCommand } from "./serve-mcp.js";
 import { createTestCommand } from "./test.js";
 export function createAIGNECommand(options) {
@@ -17,6 +18,7 @@ export function createAIGNECommand(options) {
         .version(AIGNE_CLI_VERSION)
         // default command: when user runs `aigne` without subcommand, behave like `aigne run`
         .command(createRunCommand(options))
+        .command(createRunSkillCommand())
         .command(createEvalCommand(options))
         .command(createTestCommand(options))
         .command(createCreateCommand())

package/dist/commands/app/agent.js

@@ -1,4 +1,5 @@
 import assert from "node:assert";
+import { DEFAULT_USER_ID } from "@aigne/cli/constants.js";
 import { logger } from "@aigne/core/utils/logger.js";
 import { v7 } from "@aigne/uuid";
 import { runAgentWithAIGNE } from "../../utils/run-with-aigne.js";
@@ -97,8 +98,9 @@ export async function invokeAgent(options) {
         await runAgentWithAIGNE(aigne, agent, {
             ...options.input,
             input,
-            chat: options.input.chat,
+            interactive: options.input.interactive,
             sessionId: options.input.sessionId || v7(),
+            userId: DEFAULT_USER_ID,
         });
     }
     finally {

package/dist/commands/run-skill.d.ts

@@ -0,0 +1,6 @@
+import type { CommandModule } from "yargs";
+import { type AgentRunCommonOptions } from "../utils/yargs.js";
+export declare function createRunSkillCommand(): CommandModule<unknown, {
+    skill?: string[];
+    interactive?: boolean;
+} & AgentRunCommonOptions>;

package/dist/commands/run-skill.js

@@ -0,0 +1,108 @@
+import { basename } from "node:path";
+import { AFSHistory } from "@aigne/afs-history";
+import { LocalFS } from "@aigne/afs-local-fs";
+import AgentSkillManager from "@aigne/agent-library/agent-skill-manager";
+import AskUserQuestion from "@aigne/agent-library/ask-user-question";
+import BashAgent from "@aigne/agent-library/bash";
+import { AIGNE, FunctionAgent } from "@aigne/core";
+import { z } from "zod";
+import { loadChatModel } from "../utils/aigne-hub/model.js";
+import { withAgentInputSchema } from "../utils/yargs.js";
+import { invokeAgent } from "./app/agent.js";
+export function createRunSkillCommand() {
+    return {
+        command: ["run-skill"],
+        describe: "Run Agent Skill for the specified path",
+        builder: async (yargs) => {
+            return withAgentInputSchema(yargs
+                .option("skill", {
+                array: true,
+                type: "string",
+                describe: "Path to the Agent Skill directory",
+            })
+                .option("interactive", {
+                describe: "Run in interactive chat mode",
+                type: "boolean",
+                default: false,
+                alias: ["chat"],
+            })
+                .demandOption("skill"), {
+                inputSchema: z.object({
+                    message: z.string(),
+                }),
+                optionalInputs: ["message"],
+            });
+        },
+        handler: async (options) => {
+            if (!Array.isArray(options.skill) || options.skill.length === 0) {
+                throw new Error("At least one skill path must be provided.");
+            }
+            const model = await loadChatModel({
+                model: options.model || "aignehub/anthropic/claude-sonnet-4-5",
+            });
+            const aigne = new AIGNE({ model });
+            const agent = new AgentSkillManager({
+                inputKey: "message",
+                taskRenderMode: "collapse",
+                skills: [
+                    new BashAgent({
+                        description: `\
+Execute bash scripts and return stdout and stderr output.
+
+When to use:
+- Running system commands (git, curl, etc.)
+- Executing build tools (npm, pip, make, etc.)
+- Running code scripts (python, node, etc.)
+
+Important:
+- Do NOT use bash for file operations. Use AFS tools instead (afs_list, afs_read, afs_write, afs_edit, afs_search).
+- Do NOT use 'cd'. The working directory is already set to workspace. Use relative paths directly.
+- Do NOT use 'npm i -g' or 'pip install --user'. Install dependencies locally in workspace:
+  - For Node.js: Use 'npm install <pkg>' (local) or 'npx <pkg>' (one-time run without install).
+  - For Python: Use 'pip install <pkg> -t .' or 'python -m venv .venv && source .venv/bin/activate && pip install <pkg>'.
+`,
+                        sandbox: false,
+                        permissions: {
+                            defaultMode: "ask",
+                            guard: FunctionAgent.from(async (input, options) => {
+                                const confirm = options.prompts?.confirm;
+                                if (!confirm)
+                                    throw new Error("No confirm prompt available for permission guard.");
+                                const approved = await confirm({ message: `Run command ${input.script}?` });
+                                return {
+                                    approved,
+                                };
+                            }),
+                        },
+                    }),
+                    new AskUserQuestion(),
+                ],
+                afs: {
+                    modules: [
+                        new AFSHistory({}),
+                        new LocalFS({
+                            name: "workspace",
+                            localPath: process.cwd(),
+                            description: `\
+Current working directory. All temporary files should be written here using absolute AFS paths (e.g., /modules/workspace/temp.py).
+Note: Bash is already running in this directory, so do NOT use 'cd /modules/workspace' in scripts. Use relative paths directly (e.g., python temp.py).`,
+                        }),
+                        ...options.skill.map((path) => new LocalFS({
+                            name: basename(path),
+                            localPath: path,
+                            description: "Contains Agent Skills. Use 'Skill' tool to invoke skills from this module.",
+                            agentSkills: true,
+                        })),
+                    ],
+                },
+            });
+            await invokeAgent({
+                aigne,
+                agent,
+                input: {
+                    ...options,
+                },
+            });
+        },
+    };
+}

package/dist/commands/run.d.ts

@@ -5,5 +5,5 @@ export declare function createRunCommand({ aigneFilePath, }?: {
     version?: boolean;
     path?: string;
     entryAgent?: string;
-    chat?: boolean;
+    interactive?: boolean;
 }>;

package/dist/commands/run.js

@@ -38,10 +38,11 @@ export function createRunCommand({ aigneFilePath, } = {}) {
                 alias: "v",
                 describe: "Show version number",
             })
-                .option("chat", {
-                describe: "Run chat loop in terminal",
+                .option("interactive", {
+                describe: "Run in interactive chat mode",
                 type: "boolean",
                 default: false,
+                alias: ["chat"],
             })
                 .help(false)
                 .version(false)
@@ -89,7 +90,7 @@ export function createRunCommand({ aigneFilePath, } = {}) {
             // Allow user to run all of agents in the AIGNE instances
             const allAgents = flat(aigne.agents, aigne.skills, aigne.cli.chat, aigne.mcpServer.agents);
             for (const agent of allAgents) {
-                subYargs.command(agentCommandModule({ aigne, agent, chat: options.chat }));
+                subYargs.command(agentCommandModule({ aigne, agent, chat: options.interactive }));
             }
             for (const cliAgent of aigne.cli.agents ?? []) {
                 subYargs.command(cliAgentCommandModule({

package/dist/constants.d.ts

@@ -3,3 +3,4 @@ export declare const AIGNE_CLI_VERSION: any;
 export declare const availableMemories: (typeof DefaultMemory)[];
 export declare const AIGNE_HUB_CREDITS_NOT_ENOUGH_ERROR_TYPE = "NOT_ENOUGH";
 export declare const CHAT_MODEL_OPTIONS: string[];
+export declare const DEFAULT_USER_ID = "cli-user";

package/dist/constants.js

@@ -17,3 +17,4 @@ export const CHAT_MODEL_OPTIONS = [
     "preferInputFileType",
     "reasoningEffort",
 ];
+export const DEFAULT_USER_ID = "cli-user";

package/dist/utils/run-chat-loop.d.ts

@@ -1,6 +1,7 @@
 import { type Message, type UserAgent } from "@aigne/core";
 export declare const DEFAULT_CHAT_INPUT_KEY = "message";
 export interface ChatLoopOptions {
+    userId?: string;
     sessionId?: string;
     initialCall?: Message | string;
     welcome?: string;

package/dist/utils/run-chat-loop.js

@@ -75,7 +75,7 @@ async function callAgent(userAgent, input, options) {
     const tracer = new TerminalTracer(userAgent.context, options);
     await tracer.run(userAgent, typeof input === "string"
         ? { ...options.input, [options.inputKey || DEFAULT_CHAT_INPUT_KEY]: input }
-        : { ...options.input, ...input }, { userContext: { sessionId: options.sessionId } });
+        : { ...options.input, ...input }, { userContext: { sessionId: options.sessionId, userId: options.userId } });
 }
 const COMMANDS = {
     "/exit": () => ({ exit: true }),

package/dist/utils/run-with-aigne.d.ts

@@ -15,7 +15,8 @@ export declare function runWithAIGNE(agentCreator: ((aigne: AIGNE) => PromiseOrV
     modelOptions?: ChatModelInputOptions;
     outputKey?: string;
 }): Promise<void>;
-export declare function runAgentWithAIGNE(aigne: AIGNE, agent: Agent, { sessionId, outputKey, outputFileKey, chatLoopOptions, ...options }?: {
+export declare function runAgentWithAIGNE(aigne: AIGNE, agent: Agent, { userId, sessionId, outputKey, outputFileKey, chatLoopOptions, ...options }?: {
+    userId?: string;
     sessionId?: string;
     outputKey?: string;
     outputFileKey?: string;

package/dist/utils/run-with-aigne.js

@@ -84,7 +84,7 @@ export async function runWithAIGNE(agentCreator, { aigne, argv = process.argv, c
         process.exit(1);
     });
 }
-export async function runAgentWithAIGNE(aigne, agent, { sessionId, outputKey, outputFileKey, chatLoopOptions, ...options } = {}) {
+export async function runAgentWithAIGNE(aigne, agent, { userId, sessionId, outputKey, outputFileKey, chatLoopOptions, ...options } = {}) {
     if (options.output) {
         const outputPath = isAbsolute(options.output)
             ? options.output
@@ -102,9 +102,9 @@ export async function runAgentWithAIGNE(aigne, agent, { sessionId, outputKey, ou
         }
         await writeFile(outputPath, "", "utf8");
     }
-    if (options.chat) {
+    if (options.interactive) {
         if (!isatty(process.stdout.fd)) {
-            throw new Error("--chat mode requires a TTY terminal");
+            throw new Error("--interactive mode requires a TTY terminal");
         }
         const userAgent = agent instanceof UserAgent ? agent : aigne.invoke(agent);
         await runChatLoopInTerminal(userAgent, {
@@ -113,6 +113,7 @@ export async function runAgentWithAIGNE(aigne, agent, { sessionId, outputKey, ou
             inputFileKey: agent instanceof AIAgent ? agent.inputFileKey : undefined,
             input: options.input,
             sessionId,
+            userId,
         });
         return;
     }

package/dist/utils/yargs.d.ts

@@ -4,7 +4,7 @@ import type { Argv } from "yargs";
 import { ZodType } from "zod";
 export type InferArgv<T> = T extends Argv<infer U> ? U : never;
 export declare const withRunAgentCommonOptions: (yargs: Argv) => Argv<{
-    chat: boolean;
+    interactive: boolean;
 } & {
     "session-id": string | undefined;
 } & {
@@ -57,7 +57,7 @@ export declare function inferZodType(type: ZodType, opts?: {
 export declare function withAgentInputSchema(yargs: Argv, options: Pick<Agent, "inputSchema"> & {
     optionalInputs?: string[];
 }): Argv<{
-    chat: boolean;
+    interactive: boolean;
 } & {
     "session-id": string | undefined;
 } & {

package/dist/utils/yargs.js

@@ -11,10 +11,11 @@ import { parse } from "yaml";
 import z, { ZodAny, ZodArray, ZodBoolean, ZodError, ZodNumber, ZodObject, ZodString, ZodType, ZodUnknown, } from "zod";
 const MODEL_OPTIONS_GROUP_NAME = "Model Options";
 export const withRunAgentCommonOptions = (yargs) => yargs
-    .option("chat", {
-    describe: "Run chat loop in terminal",
+    .option("interactive", {
+    describe: "Run in interactive chat mode",
     type: "boolean",
     default: false,
+    alias: ["chat"],
 })
     .option("session-id", {
     describe: "Session ID for chat-based agents to maintain context across interactions",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.59.0-beta.11",
+  "version": "1.59.0-beta.13",
   "description": "Your command center for agent development",
   "publishConfig": {
     "access": "public"
@@ -91,16 +91,16 @@
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
     "@aigne/afs": "^1.4.0-beta.5",
-    "@aigne/afs-local-fs": "^1.4.0-beta.8",
-    "@aigne/afs-history": "^1.2.0-beta.5",
-    "@aigne/agent-library": "^1.24.0-beta.10",
-    "@aigne/agentic-memory": "^1.1.6-beta.8",
-    "@aigne/aigne-hub": "^0.10.16-beta.12",
-    "@aigne/default-memory": "^1.4.0-beta.7",
+    "@aigne/afs-history": "^1.2.0-beta.6",
+    "@aigne/agent-library": "^1.24.0-beta.12",
+    "@aigne/afs-local-fs": "^1.4.0-beta.10",
+    "@aigne/agentic-memory": "^1.1.6-beta.10",
+    "@aigne/core": "^1.72.0-beta.10",
     "@aigne/observability-api": "^0.11.14-beta.1",
-    "@aigne/core": "^1.72.0-beta.8",
-    "@aigne/openai": "^0.16.16-beta.8",
-    "@aigne/secrets": "^0.1.6-beta.8"
+    "@aigne/default-memory": "^1.4.0-beta.9",
+    "@aigne/openai": "^0.16.16-beta.10",
+    "@aigne/secrets": "^0.1.6-beta.10",
+    "@aigne/aigne-hub": "^0.10.16-beta.14"
   },
   "devDependencies": {
     "@inquirer/testing": "^2.1.50",
@@ -117,7 +117,7 @@
     "rimraf": "^6.0.1",
     "typescript": "^5.9.2",
     "ufo": "^1.6.1",
-    "@aigne/test-utils": "^0.5.69-beta.8"
+    "@aigne/test-utils": "^0.5.69-beta.10"
   },
   "scripts": {
     "lint": "tsc --noEmit",

package/templates/default/README.md

@@ -42,7 +42,7 @@ echo "Hello, what can you help me with?" | aigne run
 use the following command to start an interactive chat session:
 
 ```bash
-aigne run --chat
+aigne run --interactive
 ```
 
 help: