@dccxx/auggiegw 1.0.23 → 1.0.24

package/dist/cli.js

@@ -2200,6 +2200,9 @@ 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 };
@@ -2322,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() {
@@ -2363,9 +2378,7 @@ async function getKit(kitId, apiUrl) {
   return data;
 }
 async function saveSubagentToFile(subagent) {
-  try {
-    await fs.mkdir(AUGMENT_AGENTS_DIR, { recursive: true });
-    const markdownContent = `---
+  const markdownContent = `---
 name: "${subagent.name}"
 description: "${subagent.description}"
 model: "${subagent.model}"
@@ -2373,10 +2386,24 @@ 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) {
-    throw new Error(`Failed to save subagent file for '${subagent.name}': ${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) {
@@ -2742,7 +2769,8 @@ async function handleKit(kitId) {
         subagentsCount++;
       }
     }
-    spinner.succeed(`Successfully installed kit "${kit.name}": ${promptsCount} prompts, ${subagentsCount} subagents`);
+    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);
@@ -2771,4 +2799,4 @@ program2.command("switch-account").description("Switch to a newer account from t
 program2.command("kit <kit-id>").description("Fetch and install a kit (prompts and subagents) from the public API").action(handleKit);
 program2.parse();
 
-//# debugId=C5CF051D7C5655BB64756E2164756E21
+//# debugId=31C1CEB51905863664756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dccxx/auggiegw",
-  "version": "1.0.23",
+  "version": "1.0.24",
   "description": "A Node.js TypeScript package",
   "main": "./dist/cli.js",
   "types": "./dist/cli.d.ts",

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