@dccxx/auggiegw 1.0.21 → 1.0.23

package/CLAUDE.md

@@ -40,12 +40,12 @@ just release
 
 Single-file CLI application (`src/cli.ts`) using Commander.js. All logic is contained in one file with clear separation:
 
-1. **Type Definitions** (lines 18-139): All interfaces for API responses and internal data structures
-2. **Constants** (lines 141-145): File paths for auth and session storage
-3. **Utility Functions** (lines 147-227): Config loading, auth data management
-4. **API Functions** (lines 238-472): HTTP calls to Augment Gateway API
-5. **Command Handlers** (lines 474-770): Business logic for each CLI command
-6. **CLI Setup** (lines 772-823): Commander.js program definition
+1. **Type Definitions** (lines 18-162): All interfaces for API responses and internal data structures
+2. **Constants** (lines 164-169): File paths for auth and session storage
+3. **Utility Functions** (lines 171-254): Config loading, auth data management
+4. **API Functions** (lines 265-518): HTTP calls to Augment Gateway API
+5. **Command Handlers** (lines 520-929): Business logic for each CLI command
+6. **CLI Setup** (lines 931-988): Commander.js program definition
 
 ### Key File Locations
 
@@ -53,6 +53,7 @@ Single-file CLI application (`src/cli.ts`) using Commander.js. All logic is cont
 - Augment session: `~/.augment/session.json`
 - Custom prompts: `~/.augment/commands/*.md`
 - Auggie sessions: `~/.augment/sessions/*.json`
+- Subagents: `~/.augment/agents/*.md`
 
 ## Special Logic & Non-Obvious Implementations
 
@@ -95,10 +96,13 @@ When `--refresh-commands` is provided:
 3. Saves the fetched prompts to `~/.augment/commands/`
 
 When `--refresh-commands` is NOT provided (default):
-- Skips prompt fetching entirely for faster operation
-- Only performs authentication
+1. Fetches all prompts from the API using `getAllPrompts()`
+2. Saves/overwrites prompts to `~/.augment/commands/` (existing files are overwritten)
+3. Does NOT delete local commands that aren't on the server
 
-The `--auth-only` flag takes precedence over `--refresh-commands` (if both are provided, prompts are skipped).
+The key difference: `--refresh-commands` does a full clean sync (deletes all local first), while the default only syncs server prompts to local without removing extra local files.
+
+The `--auth-only` flag takes precedence and skips all prompt operations.
 
 ### Account Switching Logic (lines 714-770)
 
@@ -108,6 +112,28 @@ The `switch-account` command:
 - Switches to the account at index `currentIndex - 1` (the newer one)
 - After switching, calls `handleFetch({ authOnly: true, deleteSession: true })`
 
+### Kit Command Logic (lines 883-929)
+
+The `kit <kit-id>` command fetches and installs a kit from the public API:
+1. Calls `/api/public/kit/{kit-id}` to fetch kit data (no authentication required)
+2. Saves prompts to `~/.augment/commands/*.md` using the same format as `savePromptToFile`
+3. Saves subagents to `~/.augment/agents/*.md` with YAML frontmatter
+
+### Subagent File Format
+
+Subagents are saved as markdown with YAML frontmatter:
+
+```markdown
+---
+name: "{subagent.name}"
+description: "{subagent.description}"
+model: "{subagent.model}"
+color: "{subagent.color}"
+---
+
+{subagent.content}
+```
+
 ### Prompt File Format (lines 310-320)
 
 Prompts are saved as markdown with YAML frontmatter:
@@ -121,10 +147,6 @@ type: "manual"
 {prompt.content}
 ```
 
-### Auto-Fix Commands on Fetch
-
-When running `fetch` (without `--auth-only`), the CLI automatically fixes existing command files by adding `type: "manual"` if missing. This happens after authentication and before the success message.
-
 ### Authentication Token Resolution (lines 197-205)
 
 `getAuthToken()` checks environment variable `AUGGIEGW_AUTH_TOKEN` first, then falls back to reading from `~/.auggiegw/auth.json`.

package/dist/cli.js

@@ -2199,6 +2199,7 @@ var AUTH_FILE = path.join(AUTH_DIR, "auth.json");
 var AUGMENT_DIR = path.join(os.homedir(), ".augment");
 var AUGMENT_SESSION_FILE = path.join(AUGMENT_DIR, "session.json");
 var AUGMENT_COMMANDS_DIR = path.join(AUGMENT_DIR, "commands");
+var AUGMENT_AGENTS_DIR = path.join(AUGMENT_DIR, "agents");
 function loadConfig() {
   const apiUrl = process.env.AUGMENT_GATEWAY_URL || "https://augmentgateway.1app.space";
   return { apiUrl };
@@ -2348,34 +2349,35 @@ async function deleteAllCommandFiles() {
   }
   return mdFiles.length;
 }
-async function fixCommandFiles() {
-  try {
-    await fs.access(AUGMENT_COMMANDS_DIR);
-  } catch {
-    return 0;
+async function getKit(kitId, apiUrl) {
+  const response = await fetch(`${apiUrl}/api/public/kit/${kitId}`, {
+    method: "GET"
+  });
+  if (!response.ok) {
+    throw new Error(`HTTP error! status: ${response.status}`);
   }
-  const files = await fs.readdir(AUGMENT_COMMANDS_DIR);
-  const mdFiles = files.filter((file) => file.endsWith(".md"));
-  let updatedCount = 0;
-  for (const file of mdFiles) {
-    const filePath = path.join(AUGMENT_COMMANDS_DIR, file);
-    const content = await fs.readFile(filePath, "utf-8");
-    if (content.startsWith("---")) {
-      const endOfFrontmatter = content.indexOf("---", 3);
-      if (endOfFrontmatter !== -1) {
-        const frontmatter = content.substring(0, endOfFrontmatter + 3);
-        const body = content.substring(endOfFrontmatter + 3);
-        if (!frontmatter.includes("type:")) {
-          const updatedFrontmatter = frontmatter.replace(/^(---\n(?:.*\n)*?)(description:[^\n]*\n)/m, `$1$2type: "manual"
-`);
-          const updatedContent = updatedFrontmatter + body;
-          await fs.writeFile(filePath, updatedContent, "utf-8");
-          updatedCount++;
-        }
-      }
-    }
+  const data = await response.json();
+  if (!data.success) {
+    throw new Error(data.message || "Failed to get kit");
+  }
+  return data;
+}
+async function saveSubagentToFile(subagent) {
+  try {
+    await fs.mkdir(AUGMENT_AGENTS_DIR, { recursive: true });
+    const markdownContent = `---
+name: "${subagent.name}"
+description: "${subagent.description}"
+model: "${subagent.model}"
+color: "${subagent.color}"
+---
+
+${subagent.content}`;
+    const filePath = path.join(AUGMENT_AGENTS_DIR, `${subagent.name}.md`);
+    await fs.writeFile(filePath, markdownContent, "utf-8");
+  } catch (error) {
+    throw new Error(`Failed to save subagent file for '${subagent.name}': ${error}`);
   }
-  return updatedCount;
 }
 async function promptInput(question, hidden = false) {
   const rl = readline.createInterface({
@@ -2623,12 +2625,16 @@ async function handleFetch(options) {
           spinner.warn(`Deleted ${deletedCount} commands, no new prompts found`);
         }
       } else {
-        spinner.text = "Fixing existing command files...";
-        const fixedCount = await fixCommandFiles();
-        if (fixedCount > 0) {
-          spinner.succeed(`Authentication successful, fixed ${fixedCount} command file(s) with type: "manual"`);
+        spinner.text = "Fetching prompts from server...";
+        const allPrompts = await getAllPrompts(token, config.apiUrl, spinner);
+        if (allPrompts.length > 0) {
+          spinner.text = `Saving ${allPrompts.length} prompts...`;
+          for (const prompt of allPrompts) {
+            await savePromptToFile(prompt);
+          }
+          spinner.succeed(`Successfully synced ${allPrompts.length} prompts from server`);
         } else {
-          spinner.succeed("Authentication successful (use --refresh-commands to update prompts)");
+          spinner.succeed("Authentication successful (no prompts found on server)");
         }
       }
     }
@@ -2707,6 +2713,41 @@ async function handleSwitchAccount() {
     process.exit(1);
   }
 }
+async function handleKit(kitId) {
+  if (!kitId) {
+    console.error("Error: Kit ID is required");
+    console.error("Usage: auggiegw kit <kit-id>");
+    process.exit(1);
+  }
+  const spinner = ora("Fetching kit...").start();
+  try {
+    const config = loadConfig();
+    spinner.text = `Fetching kit ${kitId}...`;
+    const kitResponse = await getKit(kitId, config.apiUrl);
+    const kit = kitResponse.data;
+    spinner.text = `Processing kit "${kit.name}"...`;
+    let promptsCount = 0;
+    let subagentsCount = 0;
+    if (kit.prompts && kit.prompts.length > 0) {
+      spinner.text = `Saving ${kit.prompts.length} prompts...`;
+      for (const prompt of kit.prompts) {
+        await savePromptToFile(prompt);
+        promptsCount++;
+      }
+    }
+    if (kit.subagents && kit.subagents.length > 0) {
+      spinner.text = `Saving ${kit.subagents.length} subagents...`;
+      for (const subagent of kit.subagents) {
+        await saveSubagentToFile(subagent);
+        subagentsCount++;
+      }
+    }
+    spinner.succeed(`Successfully installed kit "${kit.name}": ${promptsCount} prompts, ${subagentsCount} subagents`);
+  } catch (error) {
+    spinner.fail(`Kit fetch failed: ${error}`);
+    process.exit(1);
+  }
+}
 var program2 = new Command;
 program2.name("auggiegw").description("CLI tool for auggiegw authentication").version("1.0.0").option("--preserve-session", "Preserve Auggie session (do not delete chat history)").option("--delete-session", "Delete Auggie session (clear chat history)").option("--auth-only", "Fetch authentication session only without fetching prompts").option("--refresh-commands", "Delete all existing commands and fetch fresh ones from API");
 program2.command("login [username] [password]").description("Login and store credentials").action(handleLogin);
@@ -2727,6 +2768,7 @@ program2.command("exec <command> [args...]").description("Execute any custom com
   handleExec(command, args, sessionOptions);
 });
 program2.command("switch-account").description("Switch to a newer account from the purchased account list").action(handleSwitchAccount);
+program2.command("kit <kit-id>").description("Fetch and install a kit (prompts and subagents) from the public API").action(handleKit);
 program2.parse();
 
-//# debugId=64FF217361AEBDF264756E2164756E21
+//# debugId=C5CF051D7C5655BB64756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dccxx/auggiegw",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "A Node.js TypeScript package",
   "main": "./dist/cli.js",
   "types": "./dist/cli.d.ts",
@@ -15,6 +15,7 @@
     "prepublishOnly": "bun run lint && bun run build",
     "publish:auto": "node scripts/publish.js",
     "dev:login": "bun run src/cli.ts login",
+    "dev:kit": "bun run src/cli.ts kit cmk4idkos0000ph7wwdy86a6f",
     "dev:fetch": "bun run src/cli.ts fetch"
   },
   "devDependencies": {