@aigne/cli 1.59.0-beta.10 → 1.59.0-beta.12

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## [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)
+
+
+### Features
+
+* add session compact support for AIAgent ([#863](https://github.com/AIGNE-io/aigne-framework/issues/863)) ([9010918](https://github.com/AIGNE-io/aigne-framework/commit/9010918cd3f18b02b5c60ddc9ed5c34b568d0b28))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.5
+    * @aigne/afs-history bumped to 1.2.0-beta.5
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.8
+    * @aigne/agent-library bumped to 1.24.0-beta.10
+    * @aigne/agentic-memory bumped to 1.1.6-beta.8
+    * @aigne/aigne-hub bumped to 0.10.16-beta.12
+    * @aigne/core bumped to 1.72.0-beta.8
+    * @aigne/default-memory bumped to 1.4.0-beta.7
+    * @aigne/openai bumped to 0.16.16-beta.8
+    * @aigne/secrets bumped to 0.1.6-beta.8
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.8
+
 ## [1.59.0-beta.10](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.9...cli-v1.59.0-beta.10) (2025-12-26)
 
 

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

@@ -97,8 +97,8 @@ export async function invokeAgent(options) {
         await runAgentWithAIGNE(aigne, agent, {
             ...options.input,
             input,
-            chat: options.input.chat,
-            sessionId: v7(),
+            interactive: options.input.interactive,
+            sessionId: options.input.sessionId || v7(),
         });
     }
     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,84 @@
+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 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({
+                        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,
+                                };
+                            }),
+                        },
+                    }),
+                ],
+                afs: {
+                    modules: [
+                        new AFSHistory({}),
+                        ...options.skill.map((path) => new LocalFS({
+                            name: basename(path),
+                            localPath: path,
+                            description: `Agent Skill from local path ${path}`,
+                            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)
@@ -60,15 +61,16 @@ export function createRunCommand({ aigneFilePath, } = {}) {
                 }
             }
             const path = aigneFilePath || options.path || ".";
-            if (!(await findAIGNEFile(path).catch((error) => {
-                if (options._[0] !== "run") {
-                    yargsInstance?.showHelp();
-                }
-                else {
-                    throw error;
-                }
-                return false;
-            }))) {
+            if (!isUrl(path) &&
+                !(await findAIGNEFile(path).catch((error) => {
+                    if (options._[0] !== "run") {
+                        yargsInstance?.showHelp();
+                    }
+                    else {
+                        throw error;
+                    }
+                    return false;
+                }))) {
                 return;
             }
             // Parse model options for loading application
@@ -88,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/utils/aigne-hub/store/index.js

@@ -1,5 +1,5 @@
 import { logger } from "@aigne/core/utils/logger.js";
-import { AIGNE_ENV_FILE } from "../constants.js";
+import { AIGNE_ENV_FILE, isTest } from "../constants.js";
 import FileStore from "./file.js";
 import KeyringStore from "./keytar.js";
 import { migrateFileToKeyring } from "./migrate.js";
@@ -32,7 +32,7 @@ const getSecretStore = async () => {
         cachedSecretStore = await createSecretStore({
             filepath: AIGNE_ENV_FILE,
             serviceName: "aigne-hub",
-            // forceKeytarUnavailable: true,
+            forceKeytarUnavailable: Boolean(isTest),
         });
     }
     return cachedSecretStore;

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

@@ -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, {

package/dist/utils/yargs.d.ts

@@ -4,7 +4,9 @@ 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;
 } & {
     model: string | undefined;
 } & {
@@ -55,7 +57,9 @@ 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;
 } & {
     model: string | undefined;
 } & {

package/dist/utils/yargs.js

@@ -11,10 +11,15 @@ 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",
+    type: "string",
 })
     .option("model", {
     group: MODEL_OPTIONS_GROUP_NAME,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.59.0-beta.10",
+  "version": "1.59.0-beta.12",
   "description": "Your command center for agent development",
   "publishConfig": {
     "access": "public"
@@ -90,17 +90,17 @@
     "yoctocolors-cjs": "^2.1.3",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/afs": "^1.4.0-beta.4",
-    "@aigne/afs-history": "^1.2.0-beta.4",
-    "@aigne/afs-local-fs": "^1.4.0-beta.7",
-    "@aigne/agentic-memory": "^1.1.6-beta.7",
-    "@aigne/agent-library": "^1.24.0-beta.9",
-    "@aigne/core": "^1.72.0-beta.7",
-    "@aigne/default-memory": "^1.4.0-beta.6",
-    "@aigne/aigne-hub": "^0.10.16-beta.11",
+    "@aigne/afs-local-fs": "^1.4.0-beta.9",
+    "@aigne/afs": "^1.4.0-beta.5",
+    "@aigne/agent-library": "^1.24.0-beta.11",
+    "@aigne/agentic-memory": "^1.1.6-beta.9",
+    "@aigne/afs-history": "^1.2.0-beta.5",
+    "@aigne/aigne-hub": "^0.10.16-beta.13",
+    "@aigne/core": "^1.72.0-beta.9",
     "@aigne/observability-api": "^0.11.14-beta.1",
-    "@aigne/openai": "^0.16.16-beta.7",
-    "@aigne/secrets": "^0.1.6-beta.7"
+    "@aigne/openai": "^0.16.16-beta.9",
+    "@aigne/default-memory": "^1.4.0-beta.8",
+    "@aigne/secrets": "^0.1.6-beta.9"
   },
   "devDependencies": {
     "@inquirer/testing": "^2.1.50",
@@ -117,14 +117,14 @@
     "rimraf": "^6.0.1",
     "typescript": "^5.9.2",
     "ufo": "^1.6.1",
-    "@aigne/test-utils": "^0.5.69-beta.7"
+    "@aigne/test-utils": "^0.5.69-beta.9"
   },
   "scripts": {
     "lint": "tsc --noEmit",
     "build": "tsc --build tsconfig.build.json",
     "clean": "rimraf dist test/coverage templates/coverage",
-    "test": "run-s test:src test:templates",
-    "test:coverage": "run-s test:src:coverage test:templates:coverage",
+    "test": "npm run test:src && npm run test:templates",
+    "test:coverage": "npm run test:src:coverage && npm run test:templates:coverage",
     "test:src": "bun --cwd test test",
     "test:src:coverage": "bun --cwd test test --coverage --coverage-reporter=lcov --coverage-reporter=text",
     "test:templates": "cd templates && node --test",

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: