@aigne/cli 1.15.0 → 1.17.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## [1.17.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.16.0...cli-v1.17.0) (2025-07-01)
+
+
+### Features
+
+* **cli:** support HTTPS_PROXY and named path param ([#196](https://github.com/AIGNE-io/aigne-framework/issues/196)) ([04e684e](https://github.com/AIGNE-io/aigne-framework/commit/04e684ee26bc2d79924b0e3cb541cd07a7191804))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.17.4
+    * @aigne/anthropic bumped to 0.4.0
+    * @aigne/bedrock bumped to 0.4.0
+    * @aigne/core bumped to 1.27.0
+    * @aigne/deepseek bumped to 0.3.11
+    * @aigne/gemini bumped to 0.3.11
+    * @aigne/ollama bumped to 0.3.11
+    * @aigne/open-router bumped to 0.3.11
+    * @aigne/openai bumped to 0.5.0
+    * @aigne/xai bumped to 0.3.11
+
+## [1.16.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.15.0...cli-v1.16.0) (2025-06-30)
+
+
+### Features
+
+* **cli:** auto-load dotenv files for AIGNE CLI ([#192](https://github.com/AIGNE-io/aigne-framework/issues/192)) ([56d5632](https://github.com/AIGNE-io/aigne-framework/commit/56d5632ba427a1cf39235bcd1c30df3bc60643f6))
+* **ux:** polish tracing ux and update docs ([#193](https://github.com/AIGNE-io/aigne-framework/issues/193)) ([f80b63e](https://github.com/AIGNE-io/aigne-framework/commit/f80b63ecb1cfb00daa9b68330026da839d33f8a2))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.17.3
+    * @aigne/anthropic bumped to 0.3.10
+    * @aigne/bedrock bumped to 0.3.10
+    * @aigne/core bumped to 1.26.0
+    * @aigne/deepseek bumped to 0.3.10
+    * @aigne/gemini bumped to 0.3.10
+    * @aigne/observability bumped to 0.3.0
+    * @aigne/ollama bumped to 0.3.10
+    * @aigne/open-router bumped to 0.3.10
+    * @aigne/openai bumped to 0.4.3
+    * @aigne/xai bumped to 0.3.10
+
 ## [1.15.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.14.1...cli-v1.15.0) (2025-06-29)
 
 
@@ -29,7 +77,7 @@
 
 ### Bug Fixes
 
-* agine cli not found package ([#185](https://github.com/AIGNE-io/aigne-framework/issues/185)) ([5d98b61](https://github.com/AIGNE-io/aigne-framework/commit/5d98b6158f1e43e049a3a51a69bab88092bf1c92))
+* aigne cli not found package ([#185](https://github.com/AIGNE-io/aigne-framework/issues/185)) ([5d98b61](https://github.com/AIGNE-io/aigne-framework/commit/5d98b6158f1e43e049a3a51a69bab88092bf1c92))
 
 
 ### Dependencies

package/README.md

@@ -55,16 +55,16 @@ aigne --help
 aigne create [path]
 
 # Run an agent
-aigne run [path]
+aigne run --path xxx
 
 # Run tests
-aigne test [path]
+aigne test --path xxx
 
 # Start MCP server
-aigne serve [path] --mcp
+aigne serve --path xxx --mcp
 
 # Start observability server
-aigne observability [option]
+aigne observe [option]
 ```
 
 ## Create Command
@@ -133,7 +133,7 @@ aigne serve --mcp
 aigne serve --mcp --port 3001
 
 # Start MCP server for agents at specified path
-aigne serve path/to/agents --mcp
+aigne serve --path path/to/agents --mcp
 ```
 
 ## Serve Command (observability)
@@ -142,10 +142,10 @@ Start the service for monitoring data
 
 ```bash
 # Start observability server on default port 7890
-aigne observability
+aigne observe
 
 # Start observability server on specified port
-aigne observability --port 3001
+aigne observe --port 3001
 ```
 
 ## License

package/README.zh.md

@@ -55,16 +55,16 @@ aigne --help
 aigne create [path]
 
 # 运行代理
-aigne run [path]
+aigne run --path xxx
 
 # 运行测试
-aigne test [path]
+aigne test --path xxx
 
 # 启动 MCP 服务器
-aigne serve [path] --mcp
+aigne serve --path xxx --mcp
 
 # 启动 observability 服务器
-aigne observability [option]
+aigne observe [option]
 ```
 
 ## 创建命令 (create)
@@ -133,7 +133,7 @@ aigne serve --mcp
 aigne serve --mcp --port 3001
 
 # 为指定路径的代理启动 MCP 服务器
-aigne serve path/to/agents --mcp
+aigne serve -- path path/to/agents --mcp
 ```
 
 ## 服务命令 (observability)
@@ -142,10 +142,10 @@ aigne serve path/to/agents --mcp
 
 ```bash
 # 在默认端口 7890 启动 Observability 服务器
-aigne observability
+aigne observe
 
 # 在指定端口启动 Observability 服务器
-aigne observability --port 3001
+aigne observe --port 3001
 ```
 
 ## 协议

package/dist/cli.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
+import { config } from "dotenv-flow";
 import PrettyError from "pretty-error";
 import { createAIGNECommand } from "./commands/aigne.js";
+config({ silent: true });
 createAIGNECommand()
     .parseAsync()
     .catch((error) => {

package/dist/commands/create.js

@@ -61,7 +61,7 @@ export function createCreateCommand() {
             const destination = join(path, file);
             await cp(source, destination, { recursive: true, force: true });
         }
-        console.log("\n✅ Aigne project created successfully!");
+        console.log("\n✅ AIGNE project created successfully!");
         console.log(`\nTo use your new agent, run:\n  cd ${relative(process.cwd(), path)} && aigne run`);
     })
         .showHelpAfterError(true)

package/dist/commands/observability.js

@@ -13,10 +13,10 @@ const DEFAULT_PORT = () => tryOrThrow(() => {
     return port;
 }, (error) => new Error(`parse PORT error ${error.message}`));
 export function createObservabilityCommand() {
-    return new Command("observability")
+    return new Command("observe")
         .description("Start the observability server")
-        .option("--host <host>", "Host to run the MCP server on, use 0.0.0.0 to publicly expose the server", "localhost")
-        .option("--port <port>", "Port to run the MCP server on", (s) => Number.parseInt(s))
+        .option("--host <host>", "Host to run the observability server on, use 0.0.0.0 to publicly expose the server", "localhost")
+        .option("--port <port>", "Port to run the observability server on", (s) => Number.parseInt(s))
         .action(async (options) => {
         const port = await detectPort(options.port || DEFAULT_PORT());
         const dbUrl = getObservabilityDbPath();

package/dist/commands/run.js

@@ -7,6 +7,7 @@ import { loadModel } from "@aigne/core/loader/index.js";
 import { logger } from "@aigne/core/utils/logger.js";
 import { isNonNullable } from "@aigne/core/utils/type-utils.js";
 import { Listr, PRESET_TIMER } from "@aigne/listr2";
+import { config } from "dotenv-flow";
 import { availableMemories, availableModels } from "../constants.js";
 import { isV1Package, toAIGNEPackage } from "../utils/agent-v1.js";
 import { downloadAndExtract } from "../utils/download.js";
@@ -43,7 +44,12 @@ export function createRunCommand() {
             {
                 title: "Initialize AIGNE",
                 task: async (ctx) => {
-                    const aigne = await loadAIGNE(dir, options);
+                    // Load env files in the aigne directory
+                    config({ path: dir, silent: true });
+                    const aigne = await loadAIGNE(dir, {
+                        ...options,
+                        model: options.model || process.env.MODEL,
+                    });
                     ctx.aigne = aigne;
                 },
             },
@@ -91,10 +97,11 @@ export function createRunCommand() {
         .showSuggestionAfterError(true);
 }
 async function loadAIGNE(path, options) {
+    const models = availableModels();
     const model = options.model
-        ? await loadModel(availableModels, parseModelOption(options.model))
+        ? await loadModel(models, parseModelOption(options.model))
         : undefined;
-    return await AIGNE.load(path, { models: availableModels, memories: availableMemories, model });
+    return await AIGNE.load(path, { models, memories: availableMemories, model });
 }
 async function downloadPackage(url, cacheDir) {
     await rm(cacheDir, { recursive: true, force: true });

package/dist/commands/serve.js

@@ -16,16 +16,17 @@ const DEFAULT_PORT = () => tryOrThrow(() => {
 export function createServeCommand() {
     return new Command("serve")
         .description("Serve the agents in the specified directory as a MCP server")
-        .argument("[path]", "Path to the agents directory", ".")
+        .option("--url, --path <path_or_url>", "Path to the agents directory or URL to aigne project", ".")
         .option("--mcp", "Serve the agents as a MCP server")
         .option("--host <host>", "Host to run the MCP server on, use 0.0.0.0 to publicly expose the server", "localhost")
         .option("--port <port>", "Port to run the MCP server on", (s) => Number.parseInt(s))
         .option("--pathname <pathname>", "Pathname to the service", "/mcp")
-        .action(async (path, options) => {
+        .action(async (options) => {
+        const { path } = options;
         const absolutePath = isAbsolute(path) ? path : resolve(process.cwd(), path);
         const port = options.port || DEFAULT_PORT();
         const aigne = await AIGNE.load(absolutePath, {
-            models: availableModels,
+            models: availableModels(),
             memories: availableMemories,
         });
         if (options.mcp)

package/dist/commands/test.js

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

package/dist/constants.d.ts

@@ -1,7 +1,5 @@
 import { DefaultMemory } from "@aigne/agent-library/default-memory/index.js";
-import { AnthropicChatModel } from "@aigne/anthropic";
-import { BedrockChatModel } from "@aigne/bedrock";
-import { OpenAIChatModel } from "@aigne/openai";
+import type { LoadableModel } from "@aigne/core/loader/index.js";
 export declare const AIGNE_CLI_VERSION: string;
-export declare const availableModels: (typeof OpenAIChatModel | typeof AnthropicChatModel | typeof BedrockChatModel)[];
+export declare function availableModels(): LoadableModel[];
 export declare const availableMemories: (typeof DefaultMemory)[];

package/dist/constants.js

@@ -7,16 +7,57 @@ import { OllamaChatModel } from "@aigne/ollama";
 import { OpenRouterChatModel } from "@aigne/open-router";
 import { OpenAIChatModel } from "@aigne/openai";
 import { XAIChatModel } from "@aigne/xai";
+import { NodeHttpHandler, streamCollector } from "@smithy/node-http-handler";
+import { HttpsProxyAgent } from "https-proxy-agent";
 import pkg from "../package.json" with { type: "json" };
 export const AIGNE_CLI_VERSION = pkg.version;
-export const availableModels = [
-    OpenAIChatModel,
-    AnthropicChatModel,
-    BedrockChatModel,
-    DeepSeekChatModel,
-    GeminiChatModel,
-    OllamaChatModel,
-    OpenRouterChatModel,
-    XAIChatModel,
-];
+export function availableModels() {
+    const proxy = ["HTTPS_PROXY", "https_proxy", "HTTP_PROXY", "http_proxy", "ALL_PROXY", "all_proxy"]
+        .map((i) => process.env[i])
+        .filter(Boolean)[0];
+    const httpAgent = proxy ? new HttpsProxyAgent(proxy) : undefined;
+    return [
+        {
+            name: OpenAIChatModel.name,
+            create: (params) => new OpenAIChatModel({ ...params, clientOptions: { httpAgent } }),
+        },
+        {
+            name: AnthropicChatModel.name,
+            create: (params) => new AnthropicChatModel({ ...params, clientOptions: { httpAgent } }),
+        },
+        {
+            name: BedrockChatModel.name,
+            create: (params) => new BedrockChatModel({
+                ...params,
+                clientOptions: {
+                    requestHandler: NodeHttpHandler.create({
+                        httpAgent,
+                        httpsAgent: httpAgent,
+                    }),
+                    streamCollector,
+                },
+            }),
+        },
+        {
+            name: DeepSeekChatModel.name,
+            create: (params) => new DeepSeekChatModel({ ...params, clientOptions: { httpAgent } }),
+        },
+        {
+            name: GeminiChatModel.name,
+            create: (params) => new GeminiChatModel({ ...params, clientOptions: { httpAgent } }),
+        },
+        {
+            name: OllamaChatModel.name,
+            create: (params) => new OllamaChatModel({ ...params, clientOptions: { httpAgent } }),
+        },
+        {
+            name: OpenRouterChatModel.name,
+            create: (params) => new OpenRouterChatModel({ ...params, clientOptions: { httpAgent } }),
+        },
+        {
+            name: XAIChatModel.name,
+            create: (params) => new XAIChatModel({ ...params, clientOptions: { httpAgent } }),
+        },
+    ];
+}
 export const availableMemories = [DefaultMemory];

package/dist/utils/agent-v1.js

@@ -20,7 +20,7 @@ export async function toAIGNEPackage(src, dst) {
         agents: [],
     };
     for (const agent of definition.agents) {
-        const { content } = await assistantToAigneV2(agent, definition);
+        const { content } = await assistantToAIGNEV2(agent, definition);
         const filename = getAgentFilename(agent);
         await writeFile(join(dst, filename), content);
         aigne.agents.push(filename);
@@ -42,7 +42,7 @@ async function loadAgentV1Package(path) {
     }
     return definition;
 }
-function assistantToAigneV2(agent, project) {
+function assistantToAIGNEV2(agent, project) {
     const converter = AGENT_MAP[agent.type];
     if (!converter)
         throw new Error(`Unsupported agent type: ${agent.type}`);

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

@@ -21,7 +21,9 @@ export const createRunAIGNECommand = (name = "run") => new Command(name)
     .allowExcessArguments(true)
     .description("Run agent with AIGNE in terminal")
     .option("--chat", "Run chat loop in terminal", false)
-    .option("--model <provider[:model]>", `AI model to use in format 'provider[:model]' where model is optional. Examples: 'openai' or 'openai:gpt-4o-mini'. Available providers: ${availableModels.map((i) => i.name.toLowerCase().replace(/ChatModel$/i, "")).join(", ")} (default: openai)`)
+    .option("--model <provider[:model]>", `AI model to use in format 'provider[:model]' where model is optional. Examples: 'openai' or 'openai:gpt-4o-mini'. Available providers: ${availableModels()
+    .map((i) => i.name.toLowerCase().replace(/ChatModel$/i, ""))
+    .join(", ")} (default: openai)`)
     .option("--temperature <temperature>", "Temperature for the model (controls randomness, higher values produce more random outputs). Range: 0.0-2.0", customZodError("--temperature", (s) => z.coerce.number().min(0).max(2).parse(s)))
     .option("--top-p <top-p>", "Top P (nucleus sampling) parameter for the model (controls diversity). Range: 0.0-1.0", customZodError("--top-p", (s) => z.coerce.number().min(0).max(1).parse(s)))
     .option("--presence-penalty <presence-penalty>", "Presence penalty for the model (penalizes repeating the same tokens). Range: -2.0 to 2.0", customZodError("--presence-penalty", (s) => z.coerce.number().min(-2).max(2).parse(s)))
@@ -89,7 +91,7 @@ export async function parseAgentInputByCommander(agent, options = {}) {
     return input;
 }
 export const parseModelOption = (model) => {
-    const { provider, name } = model?.match(/(?<provider>[^:]+)(:(?<name>(\S+)))?/)?.groups ?? {};
+    const { provider, name } = (model || process.env.MODEL)?.match(/(?<provider>[^:]+)(:(?<name>(\S+)))?/)?.groups ?? {};
     return { provider, name };
 };
 export async function runWithAIGNE(agentCreator, { argv = process.argv, chatLoopOptions, modelOptions, outputKey, } = {}) {
@@ -100,7 +102,7 @@ export async function runWithAIGNE(agentCreator, { argv = process.argv, chatLoop
         if (options.logLevel) {
             logger.level = options.logLevel;
         }
-        const model = await loadModel(availableModels, {
+        const model = await loadModel(availableModels(), {
             ...parseModelOption(options.model),
             temperature: options.temperature,
             topP: options.topP,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.15.0",
+  "version": "1.17.0",
   "description": "cli for AIGNE framework",
   "publishConfig": {
     "access": "public"
@@ -38,11 +38,15 @@
     "@aigne/listr2": "^1.0.10",
     "@aigne/marked-terminal": "^7.3.1",
     "@modelcontextprotocol/sdk": "^1.11.0",
+    "@smithy/node-http-handler": "^4.0.6",
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
+    "detect-port": "^2.1.0",
+    "dotenv-flow": "^4.1.0",
     "express": "^5.1.0",
     "glob": "^11.0.2",
     "gradient-string": "^3.0.0",
+    "https-proxy-agent": "^7.0.6",
     "inquirer": "^12.6.0",
     "marked": "^15.0.11",
     "prettier": "^3.5.3",
@@ -51,18 +55,17 @@
     "wrap-ansi": "^9.0.0",
     "yaml": "^2.7.1",
     "zod": "^3.24.4",
-    "detect-port": "^2.1.0",
-    "@aigne/agent-library": "^1.17.2",
-    "@aigne/anthropic": "^0.3.9",
-    "@aigne/deepseek": "^0.3.9",
-    "@aigne/gemini": "^0.3.9",
-    "@aigne/bedrock": "^0.3.9",
-    "@aigne/ollama": "^0.3.9",
-    "@aigne/core": "^1.25.0",
-    "@aigne/observability": "^0.2.0",
-    "@aigne/open-router": "^0.3.9",
-    "@aigne/openai": "^0.4.2",
-    "@aigne/xai": "^0.3.9"
+    "@aigne/agent-library": "^1.17.4",
+    "@aigne/bedrock": "^0.4.0",
+    "@aigne/anthropic": "^0.4.0",
+    "@aigne/core": "^1.27.0",
+    "@aigne/gemini": "^0.3.11",
+    "@aigne/ollama": "^0.3.11",
+    "@aigne/observability": "^0.3.0",
+    "@aigne/deepseek": "^0.3.11",
+    "@aigne/open-router": "^0.3.11",
+    "@aigne/openai": "^0.5.0",
+    "@aigne/xai": "^0.3.11"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",

package/templates/default/.env.local.example

@@ -0,0 +1,18 @@
+# Change the name of this file to .env.local and fill in the following values
+
+# Use this for OpenAI models
+MODEL="openai:gpt-4.1"
+OPENAI_API_KEY=""
+
+# Use this for Anthropic models
+# MODEL="anthropic:claude-3-7-sonnet-latest"
+# ANTHROPIC_API_KEY="" # Your Anthropic API key
+
+# Use this for AWS Bedrock models
+# AWS_ACCESS_KEY_ID=""
+# AWS_SECRET_ACCESS_KEY=""
+# AWS_REGION=us-west-2
+# MODEL=Bedrock:us.amazon.nova-premier-v1:0
+
+# Setup proxy if needed
+# HTTPS_PROXY=http://localhost:7890

package/templates/default/README.md

@@ -1,6 +1,6 @@
-# Aigne Default Template
+# AIGNE Default Template
 
-This is the default project template for the Aigne framework, providing a basic chat agent and JavaScript code execution functionality.
+This is the default project template for the AIGNE framework, providing a basic chat agent and JavaScript code execution functionality.
 
 ## Template Structure