@dccxx/auggiegw 1.0.22 → 1.0.24

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
 
@@ -111,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:

package/dist/cli.js

@@ -2199,6 +2199,10 @@ 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");
+var CLAUDE_DIR = path.join(os.homedir(), ".claude");
+var CLAUDE_COMMANDS_DIR = path.join(CLAUDE_DIR, "commands");
+var CLAUDE_AGENTS_DIR = path.join(CLAUDE_DIR, "agents");
 function loadConfig() {
   const apiUrl = process.env.AUGMENT_GATEWAY_URL || "https://augmentgateway.1app.space";
   return { apiUrl };
@@ -2321,18 +2325,30 @@ async function getAllPrompts(token, apiUrl, spinner) {
   return allPrompts;
 }
 async function savePromptToFile(prompt) {
-  try {
-    await fs.mkdir(AUGMENT_COMMANDS_DIR, { recursive: true });
-    const markdownContent = `---
+  const markdownContent = `---
 description: ${prompt.name}
 type: "manual"
 ---
 
 ${prompt.content}`;
+  let augmentError = null;
+  let claudeError = null;
+  try {
+    await fs.mkdir(AUGMENT_COMMANDS_DIR, { recursive: true });
     const filePath = path.join(AUGMENT_COMMANDS_DIR, `${prompt.command}.md`);
     await fs.writeFile(filePath, markdownContent, "utf-8");
   } catch (error) {
-    throw new Error(`Failed to save prompt file for command '${prompt.command}': ${error}`);
+    augmentError = new Error(`Failed to save to .augment: ${error}`);
+  }
+  try {
+    await fs.mkdir(CLAUDE_COMMANDS_DIR, { recursive: true });
+    const filePath = path.join(CLAUDE_COMMANDS_DIR, `${prompt.command}.md`);
+    await fs.writeFile(filePath, markdownContent, "utf-8");
+  } catch (error) {
+    claudeError = new Error(`Failed to save to .claude: ${error}`);
+  }
+  if (augmentError && claudeError) {
+    throw new Error(`Failed to save prompt file for command '${prompt.command}': ${augmentError.message}; ${claudeError.message}`);
   }
 }
 async function deleteAllCommandFiles() {
@@ -2348,6 +2364,48 @@ async function deleteAllCommandFiles() {
   }
   return mdFiles.length;
 }
+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 data = await response.json();
+  if (!data.success) {
+    throw new Error(data.message || "Failed to get kit");
+  }
+  return data;
+}
+async function saveSubagentToFile(subagent) {
+  const markdownContent = `---
+name: "${subagent.name}"
+description: "${subagent.description}"
+model: "${subagent.model}"
+color: "${subagent.color}"
+---
+
+${subagent.content}`;
+  let augmentError = null;
+  let claudeError = null;
+  try {
+    await fs.mkdir(AUGMENT_AGENTS_DIR, { recursive: true });
+    const filePath = path.join(AUGMENT_AGENTS_DIR, `${subagent.name}.md`);
+    await fs.writeFile(filePath, markdownContent, "utf-8");
+  } catch (error) {
+    augmentError = new Error(`Failed to save to .augment: ${error}`);
+  }
+  try {
+    await fs.mkdir(CLAUDE_AGENTS_DIR, { recursive: true });
+    const filePath = path.join(CLAUDE_AGENTS_DIR, `${subagent.name}.md`);
+    await fs.writeFile(filePath, markdownContent, "utf-8");
+  } catch (error) {
+    claudeError = new Error(`Failed to save to .claude: ${error}`);
+  }
+  if (augmentError && claudeError) {
+    throw new Error(`Failed to save subagent file for '${subagent.name}': ${augmentError.message}; ${claudeError.message}`);
+  }
+}
 async function promptInput(question, hidden = false) {
   const rl = readline.createInterface({
     input: process.stdin,
@@ -2682,6 +2740,42 @@ 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
+Files saved to ~/.augment/ and ~/.claude/ directories`);
+  } 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);
@@ -2702,6 +2796,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=31D9A45346BDA22864756E2164756E21
+//# debugId=31C1CEB51905863664756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dccxx/auggiegw",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "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": {

package/specs/kit-command/requirements.md

@@ -0,0 +1,140 @@
+# Kit Command - Requirements
+
+## Feature Overview
+
+The `kit` command enables users to fetch and install pre-packaged collections of prompts and subagents from a public API endpoint. A "kit" is a bundle containing custom prompts and subagents that extend the functionality of the Auggie CLI. Files are synced to dual directories for compatibility: `~/.augment/commands/` and `~/.claude/commands/` for prompts, `~/.augment/agents/` and `~/.claude/agents/` for subagents.
+
+## User Story
+
+**As a** CLI user
+**I want to** install a kit by providing its ID
+**So that** I can quickly add multiple prompts and subagents to my Auggie environment without manual configuration
+
+## Implementation Reference
+
+- Entry point: `src/cli.ts:883-929` (handleKit function)
+- API function: `src/cli.ts:369-385` (getKit function)
+- Data models: `src/cli.ts:90-110` (SubagentData, KitData, GetKitResponse)
+- File writers: `src/cli.ts:333-349` (savePromptToFile), `src/cli.ts:387-405` (saveSubagentToFile)
+
+## Acceptance Criteria
+
+### Command Invocation
+
+- [x] WHEN the user runs `auggiegw kit <kit-id>`, THE SYSTEM SHALL fetch the kit from the public API endpoint.
+- [x] IF the kit-id argument is missing, THEN THE SYSTEM SHALL display "Error: Kit ID is required" and usage message, and exit with code 1.
+
+### API Integration
+
+- [x] THE SYSTEM SHALL make a GET request to `{apiUrl}/api/public/kit/{kitId}` without authentication headers.
+- [x] THE SYSTEM SHALL parse the response as JSON with structure `{ success: boolean, message: string, data: KitData }`.
+- [x] IF the HTTP response status is not OK, THEN THE SYSTEM SHALL throw an error with message "HTTP error! status: {status}".
+- [x] IF the response `success` field is false, THEN THE SYSTEM SHALL throw an error with the API's message or "Failed to get kit".
+
+### Data Processing
+
+- [x] WHEN the kit data is received, THE SYSTEM SHALL extract the kit name, prompts array, and subagents array.
+- [x] THE SYSTEM SHALL process prompts sequentially before processing subagents.
+- [x] THE SYSTEM SHALL track the count of successfully saved prompts and subagents.
+
+### Prompt Installation
+
+- [x] WHEN processing prompts, THE SYSTEM SHALL create the directory `~/.augment/commands/` if it does not exist.
+- [x] WHEN processing prompts, THE SYSTEM SHALL create the directory `~/.claude/commands/` if it does not exist.
+- [x] FOR EACH prompt in the kit, THE SYSTEM SHALL save a markdown file to `~/.augment/commands/{command}.md` with YAML frontmatter containing `description` and `type: "manual"` fields.
+- [x] FOR EACH prompt in the kit, THE SYSTEM SHALL save a markdown file to `~/.claude/commands/{command}.md` with YAML frontmatter containing `description` and `type: "manual"` fields.
+- [x] THE SYSTEM SHALL overwrite existing prompt files with the same filename without confirmation.
+- [x] IF a prompt file fails to save, THEN THE SYSTEM SHALL throw an error with message "Failed to save prompt file for command '{command}': {error}".
+- [x] IF a prompt file fails to save to one directory (either `.augment` or `.claude`), THEN THE SYSTEM SHALL still attempt to save to the other directory before throwing an error.
+
+### Subagent Installation
+
+- [x] WHEN processing subagents, THE SYSTEM SHALL create the directory `~/.augment/agents/` if it does not exist.
+- [x] WHEN processing subagents, THE SYSTEM SHALL create the directory `~/.claude/agents/` if it does not exist.
+- [x] FOR EACH subagent in the kit, THE SYSTEM SHALL save a markdown file to `~/.augment/agents/{name}.md` with YAML frontmatter containing `name`, `description`, `model`, and `color` fields.
+- [x] FOR EACH subagent in the kit, THE SYSTEM SHALL save a markdown file to `~/.claude/agents/{name}.md` with YAML frontmatter containing `name`, `description`, `model`, and `color` fields.
+- [x] THE SYSTEM SHALL overwrite existing subagent files with the same filename without confirmation.
+- [x] IF a subagent file fails to save, THEN THE SYSTEM SHALL throw an error with message "Failed to save subagent file for '{name}': {error}".
+- [x] IF a subagent file fails to save to one directory (either `.augment` or `.claude`), THEN THE SYSTEM SHALL still attempt to save to the other directory before throwing an error.
+
+### User Feedback
+
+- [x] WHILE fetching the kit, THE SYSTEM SHALL display a spinner with text "Fetching kit {kitId}...".
+- [x] WHILE processing the kit, THE SYSTEM SHALL update the spinner text to "Processing kit \"{name}\"...".
+- [x] WHILE saving prompts, THE SYSTEM SHALL update the spinner text to "Saving {count} prompts...".
+- [x] WHILE saving subagents, THE SYSTEM SHALL update the spinner text to "Saving {count} subagents...".
+- [x] WHEN installation completes successfully, THE SYSTEM SHALL display "Successfully installed kit \"{name}\": {promptsCount} prompts, {subagentsCount} subagents".
+- [x] WHEN installation completes successfully, THE SYSTEM SHALL display a message indicating files were saved to both `~/.augment/` and `~/.claude/` directories.
+- [x] IF any error occurs during the process, THEN THE SYSTEM SHALL display "Kit fetch failed: {error}" and exit with code 1.
+
+### File Format Specifications
+
+- [x] THE SYSTEM SHALL format prompt files with YAML frontmatter followed by content, using the template:
+  ```
+  ---
+  description: {prompt.name}
+  type: "manual"
+  ---
+
+  {prompt.content}
+  ```
+
+- [x] THE SYSTEM SHALL format subagent files with YAML frontmatter followed by content, using the template:
+  ```
+  ---
+  name: "{subagent.name}"
+  description: "{subagent.description}"
+  model: "{subagent.model}"
+  color: "{subagent.color}"
+  ---
+
+  {subagent.content}
+  ```
+
+- [x] THE SYSTEM SHALL use identical file formats for both `~/.augment/` and `~/.claude/` directories.
+
+## API Contract
+
+### Request
+- **Method**: GET
+- **Endpoint**: `{apiUrl}/api/public/kit/{kitId}`
+- **Authentication**: None (public endpoint)
+- **Parameters**: `kitId` (path parameter)
+
+### Response
+```typescript
+{
+  success: boolean;
+  message: string;
+  data: {
+    id: string;
+    name: string;
+    description: string;
+    prompts: Array<{
+      name: string;        // Display name for frontmatter
+      command: string;     // Filename (without .md extension)
+      content: string;     // Markdown content body
+    }>;
+    subagents: Array<{
+      name: string;        // Filename (without .md extension)
+      description: string;
+      model: string;
+      color: string;
+      content: string;     // Markdown content body
+    }>;
+  };
+}
+```
+
+## Implementation Notes
+
+**Status**: Completed
+**Last Updated**: 2026-01-20
+**Files**: `src/cli.ts:883-929` (handleKit), `src/cli.ts:333-349` (savePromptToFile), `src/cli.ts:387-405` (saveSubagentToFile)
+**Deviations**: None
+
+### Implementation Details
+- Prompts saved to both: `~/.augment/commands/` and `~/.claude/commands/`
+- Subagents saved to both: `~/.augment/agents/` and `~/.claude/agents/`
+- Error handling: Attempts both directories even if one fails
+- Success message indicates dual-directory syncing