@aigne/cli 1.19.0 → 1.20.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [1.20.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.19.0...cli-v1.20.0) (2025-07-02)
+
+
+### Features
+
+* **cli:** support executing aigne.yaml via shebang (#!/usr/bin/env aigne) ([#211](https://github.com/AIGNE-io/aigne-framework/issues/211)) ([2a82c27](https://github.com/AIGNE-io/aigne-framework/commit/2a82c2754b5eab5c3d6e45a5cbe7f0c76d927967))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.17.8
+    * @aigne/anthropic bumped to 0.5.3
+    * @aigne/bedrock bumped to 0.5.3
+    * @aigne/core bumped to 1.29.0
+    * @aigne/deepseek bumped to 0.4.3
+    * @aigne/gemini bumped to 0.4.3
+    * @aigne/ollama bumped to 0.4.3
+    * @aigne/open-router bumped to 0.4.3
+    * @aigne/openai bumped to 0.6.3
+    * @aigne/xai bumped to 0.4.3
+
 ## [1.19.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.18.1...cli-v1.19.0) (2025-07-01)
 
 

package/dist/cli.js

@@ -1,10 +1,22 @@
 #!/usr/bin/env node
+import { existsSync, realpathSync, statSync } from "node:fs";
 import { config } from "dotenv-flow";
 import PrettyError from "pretty-error";
 import { createAIGNECommand } from "./commands/aigne.js";
 config({ silent: true });
-createAIGNECommand()
-    .parseAsync()
+function getAIGNEFilePath() {
+    let file = process.argv[2];
+    if (file) {
+        if (!existsSync(file))
+            return;
+        file = realpathSync(file);
+        if (statSync(file).isFile())
+            return file;
+    }
+}
+const aigneFilePath = getAIGNEFilePath();
+createAIGNECommand({ aigneFilePath })
+    .parseAsync(["", "", ...process.argv.slice(aigneFilePath ? 3 : 2)])
     .catch((error) => {
     console.error(new PrettyError().render(error));
     process.exit(1);

package/dist/commands/aigne.d.ts

@@ -1,2 +1,4 @@
 import { Command } from "commander";
-export declare function createAIGNECommand(): Command;
+export declare function createAIGNECommand(options?: {
+    aigneFilePath?: string;
+}): Command;

package/dist/commands/aigne.js

@@ -6,16 +6,16 @@ import { createObservabilityCommand } from "./observe.js";
 import { createRunCommand } from "./run.js";
 import { createServeMCPCommand } from "./serve-mcp.js";
 import { createTestCommand } from "./test.js";
-export function createAIGNECommand() {
+export function createAIGNECommand(options) {
     console.log(asciiLogo);
     return new Command()
         .name("aigne")
         .description("CLI for AIGNE framework")
         .version(AIGNE_CLI_VERSION)
-        .addCommand(createRunCommand())
-        .addCommand(createTestCommand())
+        .addCommand(createRunCommand(options))
+        .addCommand(createTestCommand(options))
         .addCommand(createCreateCommand())
-        .addCommand(createServeMCPCommand())
+        .addCommand(createServeMCPCommand(options))
         .addCommand(createObservabilityCommand())
         .showHelpAfterError(true)
         .showSuggestionAfterError(true);

package/dist/commands/run.d.ts

@@ -1,2 +1,4 @@
 import type { Command } from "commander";
-export declare function createRunCommand(): Command;
+export declare function createRunCommand({ aigneFilePath }?: {
+    aigneFilePath?: string;
+}): Command;

package/dist/commands/run.js

@@ -12,14 +12,14 @@ import { availableMemories, availableModels } from "../constants.js";
 import { isV1Package, toAIGNEPackage } from "../utils/agent-v1.js";
 import { downloadAndExtract } from "../utils/download.js";
 import { createRunAIGNECommand, parseAgentInputByCommander, parseModelOption, runAgentWithAIGNE, } from "../utils/run-with-aigne.js";
-export function createRunCommand() {
+export function createRunCommand({ aigneFilePath } = {}) {
     return createRunAIGNECommand()
         .description("Run AIGNE from the specified agent")
         .option("--url, --path <path_or_url>", "Path to the agents directory or URL to aigne project", ".")
         .option("--entry-agent <entry-agent>", "Name of the agent to run (defaults to the first agent found)")
         .option("--cache-dir <dir>", "Directory to download the package to (defaults to the ~/.aigne/xxx)")
         .action(async (options) => {
-        const { path } = options;
+        const path = aigneFilePath || options.path;
         if (options.logLevel)
             logger.level = options.logLevel;
         const { cacheDir, dir } = prepareDirs(path, options);

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

@@ -1,2 +1,4 @@
 import { Command } from "commander";
-export declare function createServeMCPCommand(): Command;
+export declare function createServeMCPCommand({ aigneFilePath }?: {
+    aigneFilePath?: string;
+}): Command;

package/dist/commands/serve-mcp.js

@@ -13,7 +13,7 @@ const DEFAULT_PORT = () => tryOrThrow(() => {
         throw new Error(`Invalid PORT: ${PORT}`);
     return port;
 }, (error) => new Error(`parse PORT error ${error.message}`));
-export function createServeMCPCommand() {
+export function createServeMCPCommand({ aigneFilePath } = {}) {
     return new Command("serve-mcp")
         .description("Serve the agents in the specified directory as a MCP server (streamable http)")
         .option("--url, --path <path_or_url>", "Path to the agents directory or URL to aigne project", ".")
@@ -21,7 +21,7 @@ export function createServeMCPCommand() {
         .option("--port <port>", "Port to run the MCP server on", (s) => Number.parseInt(s))
         .option("--pathname <pathname>", "Pathname to the service", "/mcp")
         .action(async (options) => {
-        const { path } = options;
+        const path = aigneFilePath || options.path;
         const absolutePath = isAbsolute(path) ? path : resolve(process.cwd(), path);
         const port = options.port || DEFAULT_PORT();
         const aigne = await AIGNE.load(absolutePath, {

package/dist/commands/test.d.ts

@@ -1,2 +1,4 @@
 import { Command } from "commander";
-export declare function createTestCommand(): Command;
+export declare function createTestCommand({ aigneFilePath }?: {
+    aigneFilePath?: string;
+}): Command;

package/dist/commands/test.js

@@ -1,12 +1,12 @@
 import { spawnSync } from "node:child_process";
 import { isAbsolute, resolve } from "node:path";
 import { Command } from "commander";
-export function createTestCommand() {
+export function createTestCommand({ aigneFilePath } = {}) {
     return new Command("test")
         .description("Run tests in the specified agents directory")
         .option("--url, --path <path_or_url>", "Path to the agents directory or URL to aigne project", ".")
         .action(async (options) => {
-        const { path } = options;
+        const path = aigneFilePath || options.path;
         const absolutePath = isAbsolute(path) ? path : resolve(process.cwd(), path);
         spawnSync("node", ["--test"], { cwd: absolutePath, stdio: "inherit" });
     })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "cli for AIGNE framework",
   "publishConfig": {
     "access": "public"
@@ -55,17 +55,17 @@
     "wrap-ansi": "^9.0.0",
     "yaml": "^2.7.1",
     "zod": "^3.24.4",
-    "@aigne/anthropic": "^0.5.2",
-    "@aigne/bedrock": "^0.5.2",
-    "@aigne/core": "^1.28.2",
-    "@aigne/deepseek": "^0.4.2",
-    "@aigne/agent-library": "^1.17.7",
-    "@aigne/gemini": "^0.4.2",
+    "@aigne/agent-library": "^1.17.8",
+    "@aigne/anthropic": "^0.5.3",
+    "@aigne/bedrock": "^0.5.3",
+    "@aigne/deepseek": "^0.4.3",
+    "@aigne/core": "^1.29.0",
+    "@aigne/gemini": "^0.4.3",
     "@aigne/observability-api": "^0.3.2",
-    "@aigne/ollama": "^0.4.2",
-    "@aigne/open-router": "^0.4.2",
-    "@aigne/openai": "^0.6.2",
-    "@aigne/xai": "^0.4.2"
+    "@aigne/ollama": "^0.4.3",
+    "@aigne/xai": "^0.4.3",
+    "@aigne/openai": "^0.6.3",
+    "@aigne/open-router": "^0.4.3"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",