ai-devx 1.0.4 → 1.0.6

package/README.md

@@ -20,38 +20,62 @@ AI-DEVX is a powerful CLI tool that installs AI agent templates into your projec
 
 ### Installation
 
+AI-DEVX supports assistant-specific installations with different folder names:
+
 ```bash
-# Using npx (recommended)
+# Default installation (universal, all assistants)
 npx ai-devx init
+# Creates: .agent/ folder (includes both Claude and Gemini)
+
+# Claude-specific installation
+npx ai-devx init --assistant claude
+# Creates: .claude/ folder (includes only Claude rules)
+
+# Gemini-specific installation
+npx ai-devx init --assistant gemini
+# Creates: .gemini/ folder (includes only Gemini rules)
 
 # Or install globally
 npm install -g ai-devx
-ai-devx init
+ai-devx init --assistant claude
 ```
 
-This installs the `.agent` folder containing all templates into your project.
+**Folder Mapping:**
+
+- No `--assistant` flag → `.agent/` folder (universal, all assistants)
+- `--assistant claude` → `.claude/` folder (Claude-specific)
+- `--assistant gemini` → `.gemini/` folder (Gemini-specific)
+
+This allows you to have separate configurations for different AI assistants in the same project.
 
 ### Important: Git Configuration
 
-If you are using AI-powered editors like **Cursor** or **Windsurf**, adding the `.agent/` folder to your `.gitignore` may prevent the IDE from indexing the workflows. This results in slash commands (like `/plan`, `/debug`) not appearing in the chat suggestion dropdown.
+If you are using AI-powered editors like **Cursor** or **Windsurf**, adding the agent folder to your `.gitignore` may prevent the IDE from indexing the workflows. This results in slash commands (like `/plan`, `/debug`) not appearing in the chat suggestion dropdown.
 
-**Recommended Solution:** To keep the `.agent/` folder local (not tracked by Git) while maintaining AI functionality:
+**Recommended Solution:** To keep the agent folder local (not tracked by Git) while maintaining AI functionality:
 
-1. Ensure `.agent/` is **NOT** in your project's `.gitignore`
+1. Ensure the agent folder (`.agent/`, `.claude/`, or `.gemini/`) is **NOT** in your project's `.gitignore`
 2. Instead, add it to your local exclude file: `.git/info/exclude`
 
 ```bash
+# For .agent/ folder
 echo ".agent/" >> .git/info/exclude
+
+# For .claude/ folder
+echo ".claude/" >> .git/info/exclude
+
+# For .gemini/ folder
+echo ".gemini/" >> .git/info/exclude
 ```
 
 ## 📦 What's Included
 
-| Component | Count | Description |
-|-----------|-------|-------------|
-| **Agents** | 9 | Specialist AI personas |
-| **Skills** | 5+ | Domain-specific knowledge modules |
-| **Workflows** | 9 | Slash command procedures |
-| **Scripts** | 2 | Validation and automation tools |
+| Component     | Count | Description                       |
+| ------------- | ----- | --------------------------------- |
+| **Agents**    | 9     | Specialist AI personas            |
+| **Skills**    | 5+    | Domain-specific knowledge modules |
+| **Workflows** | 9     | Slash command procedures          |
+| **Scripts**   | 2     | Validation and automation tools   |
 
 ### Agents
 
@@ -83,6 +107,7 @@ AI: 🤖 Using @debugger for systematic analysis...
 ```
 
 **How it works:**
+
 - Analyzes your request silently
 - Detects domain(s) automatically (frontend, backend, security, etc.)
 - Selects the best specialist(s)
@@ -90,6 +115,7 @@ AI: 🤖 Using @debugger for systematic analysis...
 - You get specialist-level responses without needing to know the system architecture
 
 **Benefits:**
+
 - ✅ Zero learning curve - just describe what you need
 - ✅ Always get expert responses
 - ✅ Transparent - shows which agent is being used
@@ -99,16 +125,17 @@ AI: 🤖 Using @debugger for systematic analysis...
 
 Invoke workflows with slash commands:
 
-| Command | Description |
-|---------|-------------|
-| `/plan` | Create task breakdown and implementation plan |
-| `/create` | Create new features or apps |
-| `/debug` | Systematic debugging |
-| `/test` | Generate and run tests |
-| `/deploy` | Deploy application |
-| `/security` | Security audit and fixes |
+| Command     | Description                                   |
+| ----------- | --------------------------------------------- |
+| `/plan`     | Create task breakdown and implementation plan |
+| `/create`   | Create new features or apps                   |
+| `/debug`    | Systematic debugging                          |
+| `/test`     | Generate and run tests                        |
+| `/deploy`   | Deploy application                            |
+| `/security` | Security audit and fixes                      |
 
 Example:
+
 ```
 /plan user authentication system
 /create login form component
@@ -122,6 +149,7 @@ Example:
 Skills are loaded automatically based on task context. The AI reads skill descriptions and applies relevant knowledge.
 
 **Available Skills:**
+
 - **react-best-practices** - React hooks, patterns, performance
 - **api-patterns** - REST API design, authentication, best practices
 - **testing-patterns** - Unit, integration, E2E testing strategies
@@ -132,21 +160,30 @@ Skills are loaded automatically based on task context. The AI reads skill descri
 
 ### Commands
 
-| Command | Description |
-|---------|-------------|
-| `ai-devx init` | Install `.agent` folder into your project |
-| `ai-devx update` | Update to the latest version |
-| `ai-devx status` | Check installation status |
+| Command                           | Description                                 |
+| --------------------------------- | ------------------------------------------- |
+| `ai-devx init`                    | Install `.agent` folder into your project   |
+| `ai-devx init --assistant claude` | Install `.claude` folder (Claude-specific)  |
+| `ai-devx init --assistant gemini` | Install `.gemini` folder (Gemini-specific)  |
+| `ai-devx shell`                   | Start interactive shell to browse resources |
+| `ai-devx update`                  | Update to the latest version                |
+| `ai-devx status`                  | Check installation status                   |
 
 ### Options
 
 ```bash
-ai-devx init --force        # Overwrite existing .agent folder
-ai-devx init --path ./myapp # Install in specific directory
-ai-devx init --branch dev   # Use specific branch
-ai-devx init --quiet        # Suppress output (for CI/CD)
-ai-devx init --dry-run      # Preview actions without executing
-ai-devx update --backup     # Create backup before updating
+# Installation options
+ai-devx init                              # Install to .agent/ (universal)
+ai-devx init --assistant claude           # Install to .claude/ (Claude-specific)
+ai-devx init --assistant gemini           # Install to .gemini/ (Gemini-specific)
+ai-devx init --force                      # Overwrite existing folder
+ai-devx init --path ./myapp               # Install in specific directory
+ai-devx init --branch dev                 # Use specific branch
+ai-devx init --quiet                      # Suppress output (for CI/CD)
+ai-devx init --dry-run                    # Preview actions without executing
+
+# Update options
+ai-devx update --backup                   # Create backup before updating
 ```
 
 ### Validation Scripts
@@ -163,30 +200,49 @@ node .agent/scripts/security_scan.js
 
 ## 📁 Project Structure
 
+AI-DEVX can be installed to different folders depending on your assistant preference:
+
+### Universal Installation (`.agent/`)
+
 ```
 .agent/
 ├── agents/              # Agent definitions
-│   ├── frontend-specialist.md
-│   ├── backend-specialist.md
-│   ├── security-auditor.md
-│   └── ...
 ├── skills/              # Skill modules
-│   ├── react-best-practices/
-│   ├── api-patterns/
-│   ├── testing-patterns/
-│   └── ...
 ├── workflows/           # Workflow definitions
-│   ├── plan.md
-│   ├── create.md
-│   ├── debug.md
-│   └── ...
 ├── scripts/             # Validation scripts
-│   ├── checklist.js
-│   └── security_scan.js
+├── rules/               # Assistant rules
+│   ├── CLAUDE.md
+│   └── GEMINI.md
 ├── VERSION              # Current version
 └── config.json          # Installation config
 ```
 
+### Claude-Specific Installation (`.claude/`)
+
+```
+.claude/
+├── agents/              # Agent definitions
+├── skills/              # Skill modules
+├── workflows/           # Workflow definitions
+├── scripts/             # Validation scripts
+├── rules/
+│   └── CLAUDE.md        # Only Claude rules
+└── config.json
+```
+
+### Gemini-Specific Installation (`.gemini/`)
+
+```
+.gemini/
+├── agents/              # Agent definitions
+├── skills/              # Skill modules
+├── workflows/           # Workflow definitions
+├── scripts/             # Validation scripts
+├── rules/
+│   └── GEMINI.md        # Only Gemini rules
+└── config.json
+```
+
 ## 🔄 How It Works
 
 ```
@@ -238,7 +294,7 @@ Next steps:
 
 ### Debugging
 
-```
+````
 User: /debug Login button not working
 
 AI: 🤖 Applying @debugger...
@@ -253,17 +309,20 @@ Event handler not bound correctly in React component.
 // Before
 <button onClick={handleLogin}>Login</button>
 
-// After  
+// After
 <button onClick={() => handleLogin()}>Login</button>
-```
+````
 
 ### Verification
+
 ✅ Button now triggers login function
+
 ```
 
 ### Security Audit
 
 ```
+
 User: /security
 
 AI: 🤖 Applying @security-auditor...
@@ -275,9 +334,11 @@ AI: 🤖 Applying @security-auditor...
 🟡 Medium: 2
 
 ### Critical Issue
+
 Hardcoded API key in src/config.ts:15
 
 Fix: Move to environment variables
+
 ```
 
 ## 🛡️ Security
@@ -311,10 +372,6 @@ Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md)
 
 MIT © [kmamtora](https://github.com/kmamtora)
 
-## 🙏 Acknowledgments
-
-Inspired by [antigravity-kit](https://github.com/vudovn/antigravity-kit) - An amazing AI agent toolkit.
-
 ## 📞 Support
 
 - GitHub Issues: [Report a bug](https://github.com/kmamtora/ai-devx/issues)
@@ -323,3 +380,4 @@ Inspired by [antigravity-kit](https://github.com/vudovn/antigravity-kit) - An am
 ---
 
 **Happy Coding!** 🤖✨
+```

package/bin/cli.js

@@ -6,6 +6,7 @@ const pkg = require("../package.json");
 const initCommand = require("../src/commands/init");
 const updateCommand = require("../src/commands/update");
 const statusCommand = require("../src/commands/status");
+const shellCommand = require("../src/commands/shell");
 
 console.log(
   chalk.cyan.bold(`
@@ -40,8 +41,7 @@ program
   )
   .option(
     "-a, --assistant <assistants>",
-    "Comma-separated list of assistants (claude,gemini,all)",
-    "all",
+    "Comma-separated list of assistants (claude,gemini) - installs to .claude/.gemini folder",
   )
   .action(initCommand);
 
@@ -59,31 +59,50 @@ program
   .option("-p, --path <path>", "Check specific directory", process.cwd())
   .action(statusCommand);
 
+program
+  .command("shell [path]")
+  .description(
+    "Start interactive shell to browse skills, agents, and workflows",
+  )
+  .action(shellCommand);
+
 program.on("--help", () => {
   console.log("");
   console.log(chalk.bold("Examples:"));
   console.log(
-    "  $ ai-devx init                          # Install in current directory",
+    "  $ ai-devx init                          # Install to .agent/ folder",
   );
   console.log(
-    "  $ ai-devx init --path ./my-project      # Install in specific directory",
+    "  $ ai-devx init --assistant claude       # Install to .claude/ folder",
   );
   console.log(
-    "  $ ai-devx init --force                  # Overwrite existing installation",
+    "  $ ai-devx init --assistant gemini       # Install to .gemini/ folder",
+  );
+  console.log(
+    "  $ ai-devx init --path ./my-project      # Install in specific directory",
   );
   console.log(
-    "  $ ai-devx init --assistant claude       # Install with only Claude rules",
+    "  $ ai-devx init --force                  # Overwrite existing installation",
   );
   console.log(
-    "  $ ai-devx init --assistant claude,gemini # Install with both assistants",
+    "  $ ai-devx shell                         # Start interactive shell",
   );
   console.log("  $ ai-devx update                        # Update templates");
   console.log(
     "  $ ai-devx status                        # Check installation status",
   );
   console.log("");
+  console.log(chalk.bold("Folder Structure:"));
+  console.log(
+    "  Without --assistant:     .agent/    (universal, all assistants)",
+  );
+  console.log("  --assistant claude:      .claude/   (Claude-specific)");
+  console.log("  --assistant gemini:      .gemini/   (Gemini-specific)");
+  console.log("");
   console.log(chalk.bold("Quick Start:"));
-  console.log("  $ npx ai-devx init");
+  console.log("  $ npx ai-devx init --assistant claude");
+  console.log("  $ npx ai-devx init --assistant gemini");
+  console.log("  $ npx ai-devx shell");
   console.log("");
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-devx",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "AI Agent templates with Skills, Agents, and Workflows for enhanced coding assistance",
   "main": "src/index.js",
   "bin": {

package/src/commands/init.js

@@ -20,20 +20,45 @@ async function initCommand(options) {
 
   try {
     const absolutePath = path.resolve(targetPath);
-    const agentPath = path.join(absolutePath, config.AGENT_FOLDER);
+
+    // Parse assistant selection
+    let selectedAssistants;
+    let targetFolder;
+
+    if (!assistant || assistant === "all") {
+      // No assistant specified or 'all' - use .agent folder with all assistants
+      selectedAssistants = ["claude", "gemini"];
+      targetFolder = config.AGENT_FOLDER;
+    } else {
+      // Parse assistant list
+      selectedAssistants = assistant
+        .toLowerCase()
+        .split(",")
+        .map((a) => a.trim())
+        .filter((a) => ["claude", "gemini"].includes(a));
+
+      // Determine folder based on selection
+      targetFolder = config.getFolderForAssistant(selectedAssistants);
+    }
+
+    const agentPath = path.join(absolutePath, targetFolder);
 
     // Check if already installed
-    const isInstalled = await fileUtils.isInstalled(absolutePath);
+    const isInstalled = await fileUtils.isInstalled(absolutePath, targetFolder);
 
     if (isInstalled && !force && !dryRun) {
       if (spinner) spinner.stop();
-      logger.warning("AI-DEVX is already installed in this directory.");
+      logger.warning(
+        `AI-DEVX is already installed in this directory (${targetFolder}).`,
+      );
       logger.info(
         'Use --force to overwrite or run "ai-devx update" to update.',
       );
       logger.blank();
-      logger.info("To keep .agent/ local without git tracking:");
-      logger.step('Add ".agent/" to .git/info/exclude (not .gitignore)');
+      logger.info(`To keep ${targetFolder}/ local without git tracking:`);
+      logger.step(
+        `Add "${targetFolder}/" to .git/info/exclude (not .gitignore)`,
+      );
       return;
     }
 
@@ -41,6 +66,8 @@ async function initCommand(options) {
       if (spinner) spinner.stop();
       logger.info("DRY RUN - Actions that would be taken:");
       logger.step(`Install templates to: ${agentPath}`);
+      logger.step(`Assistants: ${selectedAssistants.join(", ")}`);
+      logger.step(`Target folder: ${targetFolder}`);
       if (isInstalled) logger.step("Overwrite existing installation");
       return;
     }
@@ -54,13 +81,6 @@ async function initCommand(options) {
 
     // Handle assistant selection
     if (spinner) spinner.text = "Configuring assistants...";
-    const selectedAssistants =
-      assistant === "all"
-        ? ["claude", "gemini"]
-        : assistant
-            .toLowerCase()
-            .split(",")
-            .map((a) => a.trim());
 
     const rulesPath = path.join(agentPath, "rules");
     const validAssistants = ["claude", "gemini"];
@@ -88,6 +108,7 @@ async function initCommand(options) {
       installedAt: new Date().toISOString(),
       source: source,
       assistants: selectedAssistants,
+      folder: targetFolder,
     });
 
     if (spinner) spinner.succeed("AI-DEVX templates installed successfully!");
@@ -97,10 +118,12 @@ async function initCommand(options) {
       logger.success(`Installed in: ${agentPath}`);
       logger.blank();
       logger.info("What's included:");
-      logger.step(`Agents: 9 specialist personas`);
-      logger.step(`Skills: Domain-specific knowledge modules`);
-      logger.step(`Workflows: Slash commands (/plan, /create, /debug, etc.)`);
-      logger.step(`Scripts: Validation and automation tools`);
+      logger.step(`Agents: 22 specialist personas`);
+      logger.step(`Skills: 37 domain-specific knowledge modules`);
+      logger.step(
+        `Workflows: 11 slash commands (/plan, /create, /debug, etc.)`,
+      );
+      logger.step(`Scripts: 4 validation and automation tools`);
       logger.step(`Assistants: ${selectedAssistants.join(", ")}`);
       logger.blank();
       logger.info("Quick Start:");
@@ -108,8 +131,10 @@ async function initCommand(options) {
       logger.step("Type /create to build new features");
       logger.step("Type /debug for systematic debugging");
       logger.blank();
-      logger.warning("Important: For Cursor/Windsurf compatibility");
-      logger.step('Add ".agent/" to .git/info/exclude (NOT .gitignore)');
+      logger.warning(`Important: For Cursor/Windsurf compatibility`);
+      logger.step(
+        `Add "${targetFolder}/" to .git/info/exclude (NOT .gitignore)`,
+      );
       logger.step("This keeps templates local while allowing AI indexing");
     }
   } catch (error) {