@augmentcode/auggie-sdk 0.1.12 → 0.1.13

package/README.md

@@ -312,9 +312,32 @@ const client = await Auggie.create({
   allowIndexing: true,
   apiKey: "your-api-key",  // Optional
   apiUrl: "https://your-tenant.api.augmentcode.com",  // Required when apiKey is provided
+  cliArgs: ["--verbose", "--timeout=30"],  // Optional: Additional CLI arguments
 });
 ```
 
+### Advanced CLI Arguments
+
+The `cliArgs` option allows you to pass additional command-line arguments directly to the Auggie CLI process. These arguments are appended after all SDK-generated flags.
+
+```typescript
+// Pass custom CLI flags
+const client = await Auggie.create({
+  model: "sonnet4.5",
+  cliArgs: ["--verbose", "--log-level=debug"]
+});
+
+// Arguments can use either format:
+// 1. Separate flag and value: ["--timeout", "30"]
+// 2. Combined with equals: ["--timeout=30"]
+const client2 = await Auggie.create({
+  model: "sonnet4.5",
+  cliArgs: ["--timeout=60", "--retries", "3"]
+});
+```
+
+Use this option for advanced configurations or experimental flags not exposed through standard SDK options. Refer to `auggie --help` for available CLI flags.
+
 ## Context Modes
 
 The SDK provides two context modes for codebase indexing and search.
@@ -458,6 +481,7 @@ Creates and initializes a new Auggie instance. This method automatically connect
 - `apiKey?: string` - API key for authentication (optional, sets AUGMENT_API_TOKEN)
 - `apiUrl?: string` - API URL for authentication (optional, sets AUGMENT_API_URL)
 - `excludedTools?: ToolIdentifier[]` - List of tool identifiers to exclude/disable (optional)
+- `cliArgs?: string[]` - Additional command-line arguments to pass to the Auggie CLI process (optional, default: [])
 
 When `tools` (or `toolsMap`) is provided, an MCP server is automatically started and connected to the session.
 

package/dist/auggie/sdk-acp-client.d.ts

@@ -39,6 +39,33 @@ type AuggieOptions = {
      * ```
      */
     excludedTools?: ToolIdentifier[];
+    /**
+     * Additional command-line arguments to pass to the Auggie CLI process.
+     * These arguments are appended to the CLI command when spawning the process.
+     *
+     * Use this option to pass custom or advanced CLI flags that are not
+     * directly exposed through other AuggieOptions properties.
+     *
+     * Arguments can be provided as:
+     * - Flag-only arguments: `"--verbose"`
+     * - Flag with value (separate strings): `"--timeout", "30"`
+     * - Flag with value (single string): `"--timeout=30"`
+     *
+     * @example
+     * ```typescript
+     * // Pass a single flag
+     * cliArgs: ["--verbose"]
+     *
+     * // Pass multiple arguments with values
+     * cliArgs: ["--timeout", "30", "--retries", "3"]
+     *
+     * // Pass flags with equals-style values
+     * cliArgs: ["--timeout=30", "--retries=3"]
+     * ```
+     *
+     * @default []
+     */
+    cliArgs?: string[];
 };
 /**
  * ACP Client for connecting to Auggie as an ACP server
@@ -65,6 +92,7 @@ declare class Auggie {
     private readonly apiUrl;
     private readonly rules;
     private readonly excludedTools;
+    private readonly cliArgs;
     private constructor();
     /**
      * Create and initialize a new Auggie instance

package/dist/auggie/sdk-acp-client.js

@@ -24,6 +24,7 @@ class Auggie {
   apiUrl;
   rules;
   excludedTools;
+  cliArgs;
   constructor({
     auggiePath = "auggie",
     workspaceRoot,
@@ -32,7 +33,8 @@ class Auggie {
     apiKey,
     apiUrl = process.env.AUGMENT_API_URL || "https://api.augmentcode.com",
     rules,
-    excludedTools
+    excludedTools,
+    cliArgs = []
   } = {}) {
     this.auggiePath = auggiePath;
     this.workspaceRoot = workspaceRoot;
@@ -42,6 +44,7 @@ class Auggie {
     this.apiUrl = apiUrl;
     this.rules = rules;
     this.excludedTools = excludedTools;
+    this.cliArgs = cliArgs;
   }
   /**
    * Create and initialize a new Auggie instance
@@ -81,6 +84,9 @@ class Auggie {
         args.push("--remove-tool", tool);
       }
     }
+    if (this.cliArgs.length > 0) {
+      args.push(...this.cliArgs);
+    }
     const pathParts = this.auggiePath.trim().split(Auggie.PATH_SPLIT_REGEX);
     if (pathParts.length === 0 || !pathParts[0]) {
       throw new Error("Invalid auggiePath: cannot be empty");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@augmentcode/auggie-sdk",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "TypeScript SDK for Auggie",
   "type": "module",
   "main": "./dist/index.js",