clavix 3.3.2 → 3.5.0

package/README.md

@@ -12,10 +12,10 @@
 
 | Version | Highlights | Details |
 | --- | --- | --- |
-| **v3.1.0** (Latest) | Clavix Intelligence™ brand evolution | [Changelog](CHANGELOG.md#310---2025-11-23) |
-| **v3.0.1** | Enhanced intent detection (95%+ accuracy) | [Changelog](CHANGELOG.md#301---2025-11-22) |
-| **v2.8.0** | Pure ESM package (breaking change) | [Changelog](CHANGELOG.md#280---2025-11-17) |
-| **v2.7.0** | Prompt lifecycle management | [Changelog](CHANGELOG.md#270---2025-11-15) |
+| **v3.4.0** (Latest) | Provider categorization fixes | [Changelog](CHANGELOG.md#340---2025-11-24) |
+| **v3.3.1** | JSON5/JSON config bug fix | [Changelog](CHANGELOG.md#331---2025-11-23) |
+| **v3.3.0** | Provider management & interactive config | [Changelog](CHANGELOG.md#330---2025-11-23) |
+| **v3.1.0** | Clavix Intelligence™ brand evolution | [Changelog](CHANGELOG.md#310---2025-11-23) |
 
 **Requirements:** Node.js ≥ 16.0.0 (ESM support required)
 
@@ -44,10 +44,10 @@ Clavix uses **Clavix Intelligence™** (v3.0+) to automatically:
 | Category | Providers |
 | --- | --- |
 | IDE & editor extensions | Cursor · Windsurf · Kilocode · Roocode · Cline |
-| CLI agents | Claude Code · Droid CLI · CodeBuddy CLI · OpenCode · Gemini CLI · Qwen Code · Amp · Crush CLI · Codex CLI · Augment CLI |
+| CLI agents | Claude Code · Droid CLI · CodeBuddy CLI · OpenCode · Gemini CLI · Qwen Code · LLXPRT · Amp · Crush CLI · Codex CLI · Augment CLI |
 | Universal adapters | AGENTS.md · GitHub Copilot · OCTO.md · WARP.md |
 
-Provider paths and argument placeholders are listed in [docs/providers.md](docs/providers.md).
+Provider paths and argument placeholders are listed in [docs/integrations.md](docs/integrations.md).
 
 ## Quickstart
 
@@ -81,7 +81,7 @@ clavix implement         # Start implementation workflow
 clavix task-complete <taskId>  # Mark tasks done with auto-commit
 ```
 
-**Supported agents**: Claude Code, Cursor, Windsurf, and [15+ more providers](docs/providers.md)
+**Supported agents**: Claude Code, Cursor, Windsurf, and [17+ more providers](docs/integrations.md)
 
 Learn more: [Complete prompt lifecycle documentation](docs/commands/execute.md)
 
@@ -99,7 +99,7 @@ clavix prd
 ## Full documentation
 - Overview & navigation: [docs/README.md](docs/README.md)
 - Command reference: [docs/commands/](docs/commands/README.md)
-- Providers: [docs/providers.md](docs/providers.md)
+- Providers: [docs/integrations.md](docs/integrations.md)
 - Clavix Intelligence: [docs/clavix-intelligence.md](docs/clavix-intelligence.md)
 - Guides: [docs/guides/](docs/guides/workflows.md)
 

package/dist/cli/commands/config.d.ts

@@ -12,10 +12,10 @@ export default class Config extends Command {
     };
     run(): Promise<void>;
     private showInteractiveMenu;
-    private manageProviders;
-    private addProviders;
-    private removeProviders;
-    private replaceProviders;
+    private manageIntegrations;
+    private addIntegrations;
+    private removeIntegrations;
+    private replaceIntegrations;
     private getConfig;
     private setConfig;
     private editConfig;

package/dist/cli/commands/config.js

@@ -10,7 +10,7 @@ export default class Config extends Command {
     static description = 'Manage Clavix configuration';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> get providers',
+        '<%= config.bin %> <%= command.id %> get integrations',
         '<%= config.bin %> <%= command.id %> set preferences.verboseLogging true',
     ];
     static args = {
@@ -84,7 +84,7 @@ export default class Config extends Command {
                     message: 'What would you like to do?',
                     choices: [
                         { name: 'View current configuration', value: 'view' },
-                        { name: 'Manage providers (add/remove)', value: 'providers' },
+                        { name: 'Manage integrations (add/remove)', value: 'integrations' },
                         { name: 'Edit preferences', value: 'edit-preferences' },
                         { name: 'Reset to defaults', value: 'reset' },
                         { name: 'Exit', value: 'exit' },
@@ -95,8 +95,8 @@ export default class Config extends Command {
                 case 'view':
                     // Already displayed above
                     break;
-                case 'providers':
-                    await this.manageProviders(config, configPath);
+                case 'integrations':
+                    await this.manageIntegrations(config, configPath);
                     break;
                 case 'edit-preferences':
                     await this.editPreferences(configPath, config);
@@ -110,18 +110,18 @@ export default class Config extends Command {
             }
         }
     }
-    async manageProviders(config, configPath) {
+    async manageIntegrations(config, configPath) {
         const agentManager = new AgentManager();
         while (true) {
-            // Show current providers
-            this.log(chalk.cyan('\n📦 Current Providers:'));
-            if (config.providers.length === 0) {
+            // Show current integrations
+            this.log(chalk.cyan('\n📦 Current Integrations:'));
+            if (config.integrations.length === 0) {
                 this.log(chalk.gray('  (none configured)'));
             }
             else {
-                for (const providerName of config.providers) {
-                    const adapter = agentManager.getAdapter(providerName);
-                    const displayName = adapter?.displayName || providerName;
+                for (const integrationName of config.integrations) {
+                    const adapter = agentManager.getAdapter(integrationName);
+                    const displayName = adapter?.displayName || integrationName;
                     this.log(chalk.gray(`  • ${displayName}`));
                 }
             }
@@ -132,9 +132,9 @@ export default class Config extends Command {
                     name: 'action',
                     message: 'What would you like to do?',
                     choices: [
-                        { name: 'Add provider', value: 'add' },
-                        { name: 'Remove provider', value: 'remove' },
-                        { name: 'Replace all providers', value: 'replace' },
+                        { name: 'Add integration', value: 'add' },
+                        { name: 'Remove integration', value: 'remove' },
+                        { name: 'Replace all integrations', value: 'replace' },
                         { name: 'Back to main menu', value: 'back' },
                     ],
                 },
@@ -143,33 +143,33 @@ export default class Config extends Command {
                 break;
             switch (action) {
                 case 'add':
-                    await this.addProviders(config, configPath);
+                    await this.addIntegrations(config, configPath);
                     break;
                 case 'remove':
-                    await this.removeProviders(config, configPath);
+                    await this.removeIntegrations(config, configPath);
                     break;
                 case 'replace':
-                    await this.replaceProviders(config, configPath);
+                    await this.replaceIntegrations(config, configPath);
                     break;
             }
             // Reload config after modifications
             config = this.loadConfig(configPath);
         }
     }
-    async addProviders(config, configPath) {
+    async addIntegrations(config, configPath) {
         const agentManager = new AgentManager();
-        const allProviders = agentManager.getAdapters();
+        const allIntegrations = agentManager.getAdapters();
         // Show only non-selected providers
-        const availableToAdd = allProviders.filter((a) => !config.providers.includes(a.name));
+        const availableToAdd = allIntegrations.filter((a) => !config.integrations.includes(a.name));
         if (availableToAdd.length === 0) {
-            this.log(chalk.yellow('\n✓ All providers already added!'));
+            this.log(chalk.yellow('\n✓ All integrations already added!'));
             return;
         }
         // Multi-select checkbox
-        const { newProviders } = await inquirer.prompt([
+        const { newIntegrations } = await inquirer.prompt([
             {
                 type: 'checkbox',
-                name: 'newProviders',
+                name: 'newIntegrations',
                 message: 'Select providers to add:',
                 choices: availableToAdd.map((adapter) => ({
                     name: `${adapter.displayName} (${adapter.directory})`,
@@ -177,38 +177,38 @@ export default class Config extends Command {
                 })),
             },
         ]);
-        if (newProviders.length === 0) {
-            this.log(chalk.gray('No providers selected'));
+        if (newIntegrations.length === 0) {
+            this.log(chalk.gray('No integrations selected'));
             return;
         }
         // Add to config
-        config.providers.push(...newProviders);
+        config.integrations.push(...newIntegrations);
         this.saveConfig(configPath, config);
-        this.log(chalk.gray('\n🔧 Generating commands for new providers...'));
-        // Generate commands for new providers
-        for (const providerName of newProviders) {
-            const adapter = agentManager.getAdapter(providerName);
+        this.log(chalk.gray('\n🔧 Generating commands for new integrations...'));
+        // Generate commands for new integrations
+        for (const integrationName of newIntegrations) {
+            const adapter = agentManager.getAdapter(integrationName);
             if (!adapter)
                 continue;
             const templates = await loadCommandTemplates(adapter);
             await adapter.generateCommands(templates);
             this.log(chalk.green(`  ✓ Generated ${templates.length} command(s) for ${adapter.displayName}`));
         }
-        this.log(chalk.green('\n✅ Providers added successfully!'));
+        this.log(chalk.green('\n✅ Integrations added successfully!'));
     }
-    async removeProviders(config, configPath) {
-        if (config.providers.length === 0) {
-            this.log(chalk.yellow('\n⚠ No providers configured!'));
+    async removeIntegrations(config, configPath) {
+        if (config.integrations.length === 0) {
+            this.log(chalk.yellow('\n⚠ No integrations configured!'));
             return;
         }
         const agentManager = new AgentManager();
-        // Multi-select from current providers
-        const { providersToRemove } = await inquirer.prompt([
+        // Multi-select from current integrations
+        const { integrationsToRemove } = await inquirer.prompt([
             {
                 type: 'checkbox',
-                name: 'providersToRemove',
+                name: 'integrationsToRemove',
                 message: 'Select providers to remove:',
-                choices: config.providers.map((name) => {
+                choices: config.integrations.map((name) => {
                     const adapter = agentManager.getAdapter(name);
                     return {
                         name: `${adapter?.displayName || name} (${adapter?.directory || 'unknown'})`,
@@ -216,15 +216,15 @@ export default class Config extends Command {
                     };
                 }),
                 validate: (answer) => {
-                    if (answer.length === config.providers.length) {
-                        return 'You must keep at least one provider. Use "Reset to defaults" to reconfigure completely.';
+                    if (answer.length === config.integrations.length) {
+                        return 'You must keep at least one integration. Use "Reset to defaults" to reconfigure completely.';
                     }
                     return true;
                 },
             },
         ]);
-        if (providersToRemove.length === 0) {
-            this.log(chalk.gray('No providers selected'));
+        if (integrationsToRemove.length === 0) {
+            this.log(chalk.gray('No integrations selected'));
             return;
         }
         // Confirm cleanup
@@ -232,43 +232,43 @@ export default class Config extends Command {
             {
                 type: 'confirm',
                 name: 'cleanup',
-                message: 'Remove command files for these providers?',
+                message: 'Remove command files for these integrations?',
                 default: true,
             },
         ]);
         // Remove from config
-        config.providers = config.providers.filter((p) => !providersToRemove.includes(p));
+        config.integrations = config.integrations.filter((p) => !integrationsToRemove.includes(p));
         this.saveConfig(configPath, config);
         // Clean up command files
         if (cleanup) {
             this.log(chalk.gray('\n🗑️  Cleaning up command files...'));
-            for (const providerName of providersToRemove) {
-                const adapter = agentManager.getAdapter(providerName);
+            for (const integrationName of integrationsToRemove) {
+                const adapter = agentManager.getAdapter(integrationName);
                 if (adapter) {
                     const removed = await adapter.removeAllCommands();
                     this.log(chalk.gray(`  ✓ Removed ${removed} command(s) from ${adapter.displayName}`));
                 }
             }
         }
-        this.log(chalk.green('\n✅ Providers removed successfully!'));
+        this.log(chalk.green('\n✅ Integrations removed successfully!'));
     }
-    async replaceProviders(config, configPath) {
+    async replaceIntegrations(config, configPath) {
         const agentManager = new AgentManager();
         // Use shared provider selector
-        const { selectProviders } = await import('../../utils/provider-selector.js');
-        const newProviders = await selectProviders(agentManager, config.providers);
-        if (newProviders.length === 0) {
-            this.log(chalk.gray('No providers selected'));
+        const { selectIntegrations } = await import('../../utils/integration-selector.js');
+        const newIntegrations = await selectIntegrations(agentManager, config.integrations);
+        if (newIntegrations.length === 0) {
+            this.log(chalk.gray('No integrations selected'));
             return;
         }
-        // Find deselected providers
-        const deselected = config.providers.filter((p) => !newProviders.includes(p));
+        // Find deselected integrations
+        const deselected = config.integrations.filter((p) => !newIntegrations.includes(p));
         // Handle cleanup if providers were deselected
         if (deselected.length > 0) {
             this.log(chalk.yellow('\n⚠ Previously configured but not selected:'));
-            for (const providerName of deselected) {
-                const adapter = agentManager.getAdapter(providerName);
-                const displayName = adapter?.displayName || providerName;
+            for (const integrationName of deselected) {
+                const adapter = agentManager.getAdapter(integrationName);
+                const displayName = adapter?.displayName || integrationName;
                 const directory = adapter?.directory || 'unknown';
                 this.log(chalk.gray(`  • ${displayName} (${directory})`));
             }
@@ -276,7 +276,7 @@ export default class Config extends Command {
                 {
                     type: 'list',
                     name: 'cleanupAction',
-                    message: 'What would you like to do with these providers?',
+                    message: 'What would you like to do with these integrations?',
                     choices: [
                         { name: 'Clean up (remove all command files)', value: 'cleanup' },
                         { name: 'Skip (leave as-is)', value: 'skip' },
@@ -284,9 +284,9 @@ export default class Config extends Command {
                 },
             ]);
             if (cleanupAction === 'cleanup') {
-                this.log(chalk.gray('\n🗑️  Cleaning up deselected providers...'));
-                for (const providerName of deselected) {
-                    const adapter = agentManager.getAdapter(providerName);
+                this.log(chalk.gray('\n🗑️  Cleaning up deselected integrations...'));
+                for (const integrationName of deselected) {
+                    const adapter = agentManager.getAdapter(integrationName);
                     if (adapter) {
                         const removed = await adapter.removeAllCommands();
                         this.log(chalk.gray(`  ✓ Removed ${removed} command(s) from ${adapter.displayName}`));
@@ -295,7 +295,7 @@ export default class Config extends Command {
             }
         }
         // Update config
-        config.providers = newProviders;
+        config.integrations = newIntegrations;
         this.saveConfig(configPath, config);
         // Prompt to run update
         const { runUpdate } = await inquirer.prompt([
@@ -307,11 +307,11 @@ export default class Config extends Command {
             },
         ]);
         if (runUpdate) {
-            this.log(chalk.gray('\n🔧 Regenerating commands for all providers...\n'));
+            this.log(chalk.gray('\n🔧 Regenerating commands for all integrations...\n'));
             const Update = (await import('./update.js')).default;
             await Update.run([]);
         }
-        this.log(chalk.green('\n✅ Providers replaced successfully!'));
+        this.log(chalk.green('\n✅ Integrations replaced successfully!'));
     }
     async getConfig(configPath, key) {
         const config = this.loadConfig(configPath);
@@ -363,10 +363,10 @@ export default class Config extends Command {
         const config = this.loadConfig(configPath);
         const defaultConfig = {
             ...DEFAULT_CONFIG,
-            providers: config.providers, // Keep existing providers
+            providers: config.integrations, // Keep existing integrations
         };
         this.saveConfig(configPath, defaultConfig);
-        this.log(chalk.green('✅ Configuration reset to defaults (providers preserved)'));
+        this.log(chalk.green('✅ Configuration reset to defaults (integrations preserved)'));
     }
     async editPreferences(configPath, config) {
         const preferences = config.preferences || DEFAULT_CONFIG.preferences;
@@ -420,7 +420,7 @@ export default class Config extends Command {
     }
     displayConfig(config) {
         this.log(`  ${chalk.gray('Version:')} ${config.version}`);
-        this.log(`  ${chalk.gray('Providers:')} ${config.providers.map(p => chalk.cyan(p)).join(', ') || chalk.gray('(none)')}`);
+        this.log(`  ${chalk.gray('Integrations:')} ${config.integrations.map(p => chalk.cyan(p)).join(', ') || chalk.gray('(none)')}`);
         if (config.preferences) {
             this.log(`\n  ${chalk.bold('Preferences:')}`);
             this.log(`    ${chalk.gray('Auto-open outputs:')} ${config.preferences.autoOpenOutputs ? chalk.green('yes') : chalk.gray('no')}`);

package/dist/cli/commands/init.js

@@ -39,33 +39,33 @@ export default class Init extends Command {
             }
             // Load existing config if re-initializing
             const agentManager = new AgentManager();
-            let existingProviders = [];
+            let existingIntegrations = [];
             if (await FileSystem.exists('.clavix/config.json')) {
                 try {
                     const configContent = await FileSystem.readFile('.clavix/config.json');
                     const config = JSON.parse(configContent);
-                    existingProviders = config.providers || [];
+                    existingIntegrations = config.integrations || config.providers || [];
                 }
                 catch (error) {
                     // Ignore parse errors, will use empty array
                 }
             }
-            // Select providers using shared utility
+            // Select integrations using shared utility
             console.log(chalk.gray('Select AI development tools to support:\n'));
             console.log(chalk.gray('(Space to select, Enter to confirm)\n'));
-            const { selectProviders } = await import('../../utils/provider-selector.js');
-            const selectedProviders = await selectProviders(agentManager, existingProviders);
-            if (!selectedProviders || selectedProviders.length === 0) {
-                console.log(chalk.red('\n✗ No providers selected\n'));
+            const { selectIntegrations } = await import('../../utils/integration-selector.js');
+            const selectedIntegrations = await selectIntegrations(agentManager, existingIntegrations);
+            if (!selectedIntegrations || selectedIntegrations.length === 0) {
+                console.log(chalk.red('\n✗ No integrations selected\n'));
                 return;
             }
-            // Handle deselected providers (cleanup prompt)
-            const deselectedProviders = existingProviders.filter((p) => !selectedProviders.includes(p));
-            if (deselectedProviders.length > 0) {
+            // Handle deselected integrations (cleanup prompt)
+            const deselectedIntegrations = existingIntegrations.filter((p) => !selectedIntegrations.includes(p));
+            if (deselectedIntegrations.length > 0) {
                 console.log(chalk.yellow('\n⚠ Previously configured but not selected:'));
-                for (const providerName of deselectedProviders) {
-                    const adapter = agentManager.getAdapter(providerName);
-                    const displayName = adapter?.displayName || providerName;
+                for (const integrationName of deselectedIntegrations) {
+                    const adapter = agentManager.getAdapter(integrationName);
+                    const displayName = adapter?.displayName || integrationName;
                     const directory = adapter?.directory || 'unknown';
                     console.log(chalk.gray(`  • ${displayName} (${directory})`));
                 }
@@ -73,7 +73,7 @@ export default class Init extends Command {
                     {
                         type: 'list',
                         name: 'cleanupAction',
-                        message: 'What would you like to do with these providers?',
+                        message: 'What would you like to do with these integrations?',
                         choices: [
                             { name: 'Clean up (remove all command files)', value: 'cleanup' },
                             { name: 'Keep (also update their commands)', value: 'update' },
@@ -82,9 +82,9 @@ export default class Init extends Command {
                     },
                 ]);
                 if (cleanupAction === 'cleanup') {
-                    console.log(chalk.gray('\n🗑️  Cleaning up deselected providers...'));
-                    for (const providerName of deselectedProviders) {
-                        const adapter = agentManager.getAdapter(providerName);
+                    console.log(chalk.gray('\n🗑️  Cleaning up deselected integrations...'));
+                    for (const integrationName of deselectedIntegrations) {
+                        const adapter = agentManager.getAdapter(integrationName);
                         if (adapter) {
                             const removed = await adapter.removeAllCommands();
                             console.log(chalk.gray(`  ✓ Removed ${removed} command(s) from ${adapter.displayName}`));
@@ -93,8 +93,8 @@ export default class Init extends Command {
                 }
                 else if (cleanupAction === 'update') {
                     // Add them back to selection
-                    selectedProviders.push(...deselectedProviders);
-                    console.log(chalk.gray('\n✓ Keeping all providers\n'));
+                    selectedIntegrations.push(...deselectedIntegrations);
+                    console.log(chalk.gray('\n✓ Keeping all integrations\n'));
                 }
                 // If 'skip': do nothing
             }
@@ -103,36 +103,36 @@ export default class Init extends Command {
             await this.createDirectoryStructure();
             // Generate config
             console.log(chalk.cyan('⚙️  Generating configuration...'));
-            await this.generateConfig(selectedProviders);
+            await this.generateConfig(selectedIntegrations);
             // Generate INSTRUCTIONS.md
             await this.generateInstructions();
-            // Generate commands for each selected provider
-            console.log(chalk.cyan(`\n📝 Generating commands for ${selectedProviders.length} provider(s)...\n`));
-            for (const providerName of selectedProviders) {
+            // Generate commands for each selected integration
+            console.log(chalk.cyan(`\n📝 Generating commands for ${selectedIntegrations.length} integration(s)...\n`));
+            for (const integrationName of selectedIntegrations) {
                 // Handle agents-md separately (it's not an adapter)
-                if (providerName === 'agents-md') {
+                if (integrationName === 'agents-md') {
                     console.log(chalk.gray('  ✓ Generating AGENTS.md...'));
                     await AgentsMdGenerator.generate();
                     continue;
                 }
                 // Handle copilot-instructions separately (it's not an adapter)
-                if (providerName === 'copilot-instructions') {
+                if (integrationName === 'copilot-instructions') {
                     console.log(chalk.gray('  ✓ Generating .github/copilot-instructions.md...'));
                     await CopilotInstructionsGenerator.generate();
                     continue;
                 }
                 // Handle octo-md separately (it's not an adapter)
-                if (providerName === 'octo-md') {
+                if (integrationName === 'octo-md') {
                     console.log(chalk.gray('  ✓ Generating OCTO.md...'));
                     await OctoMdGenerator.generate();
                     continue;
                 }
-                if (providerName === 'warp-md') {
+                if (integrationName === 'warp-md') {
                     console.log(chalk.gray('  ✓ Generating WARP.md...'));
                     await WarpMdGenerator.generate();
                     continue;
                 }
-                let adapter = agentManager.requireAdapter(providerName);
+                let adapter = agentManager.requireAdapter(integrationName);
                 console.log(chalk.gray(`  ✓ Generating ${adapter.displayName} commands...`));
                 if (adapter.name === 'codex') {
                     const codexPath = adapter.getCommandPath();
@@ -211,7 +211,7 @@ export default class Init extends Command {
                     console.log(chalk.gray('    Tip: reopen the CLI or run /help to refresh the command list.'));
                 }
                 // Inject documentation blocks (Claude Code only)
-                if (providerName === 'claude-code') {
+                if (integrationName === 'claude-code') {
                     console.log(chalk.gray('  ✓ Injecting CLAUDE.md documentation...'));
                     await this.injectDocumentation(adapter);
                 }
@@ -245,10 +245,10 @@ export default class Init extends Command {
             await FileSystem.ensureDir(dir);
         }
     }
-    async generateConfig(providers) {
+    async generateConfig(integrations) {
         const config = {
             ...DEFAULT_CONFIG,
-            providers,
+            integrations,
         };
         const configPath = '.clavix/config.json';
         const configContent = JSON.stringify(config, null, 2);

package/dist/cli/commands/update.js

@@ -47,44 +47,44 @@ export default class Update extends Command {
                 chalk.yellow(' to initialize Clavix in this project.'));
         }
         this.log(chalk.bold.cyan('🔄 Updating Clavix integration...\n'));
-        // Load config to determine providers
+        // Load config to determine integrations
         const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-        const providers = config.providers || ['claude-code'];
+        const integrations = config.integrations || config.providers || ['claude-code'];
         const agentManager = new AgentManager();
         const updateDocs = flags['docs-only'] || (!flags['docs-only'] && !flags['commands-only']);
         const updateCommands = flags['commands-only'] || (!flags['docs-only'] && !flags['commands-only']);
         let updatedCount = 0;
         // Update for each provider
-        for (const providerName of providers) {
+        for (const integrationName of integrations) {
             // Handle AGENTS.md separately
-            if (providerName === 'agents-md') {
+            if (integrationName === 'agents-md') {
                 if (updateDocs) {
                     updatedCount += await this.updateAgentsMd(flags.force);
                 }
                 continue;
             }
             // Handle Warp separately
-            if (providerName === 'warp-md') {
+            if (integrationName === 'warp-md') {
                 if (updateDocs) {
                     updatedCount += await this.updateWarpMd(flags.force);
                 }
                 continue;
             }
             // Handle Octofriend separately
-            if (providerName === 'octo-md') {
+            if (integrationName === 'octo-md') {
                 if (updateDocs) {
                     updatedCount += await this.updateOctoMd(flags.force);
                 }
                 continue;
             }
-            const adapter = agentManager.getAdapter(providerName);
+            const adapter = agentManager.getAdapter(integrationName);
             if (!adapter) {
-                this.log(chalk.yellow(`  ⚠ Unknown provider: ${providerName}, skipping...`));
+                this.log(chalk.yellow(`  ⚠ Unknown integration: ${integrationName}, skipping...`));
                 continue;
             }
             // Update documentation blocks (Claude Code only)
-            if (updateDocs && providerName === 'claude-code') {
-                updatedCount += await this.updateDocumentation(adapter, providerName, flags.force);
+            if (updateDocs && integrationName === 'claude-code') {
+                updatedCount += await this.updateDocumentation(adapter, integrationName, flags.force);
             }
             // Update slash commands
             if (updateCommands) {

package/dist/core/adapters/base-adapter.d.ts

@@ -1,6 +1,6 @@
-import { AgentAdapter, CommandTemplate, ManagedBlock, ProviderFeatures, ValidationResult } from '../../types/agent.js';
+import { AgentAdapter, CommandTemplate, ManagedBlock, IntegrationFeatures, ValidationResult } from '../../types/agent.js';
 /**
- * Base adapter class with shared logic for all providers
+ * Base adapter class with shared logic for all integrations
  * Ensures consistency and reduces code duplication
  */
 export declare abstract class BaseAdapter implements AgentAdapter {
@@ -8,12 +8,12 @@ export declare abstract class BaseAdapter implements AgentAdapter {
     abstract readonly displayName: string;
     abstract readonly directory: string;
     abstract readonly fileExtension: string;
-    readonly features?: ProviderFeatures;
+    readonly features?: IntegrationFeatures;
     abstract detectProject(): Promise<boolean>;
     abstract getCommandPath(): string;
     /**
      * Determine the target filename for a generated command
-     * Providers can override to customize filename conventions
+     * Integrations can override to customize filename conventions
      */
     getTargetFilename(name: string): string;
     /**
@@ -29,25 +29,25 @@ export declare abstract class BaseAdapter implements AgentAdapter {
     removeAllCommands(): Promise<number>;
     /**
      * Determine if a file is a Clavix-generated command
-     * Override in adapters for provider-specific patterns
+     * Override in adapters for integration-specific patterns
      * @param filename The filename to check
      * @returns true if this is a Clavix-generated command file
      */
     protected isClavixGeneratedCommand(filename: string): boolean;
     /**
      * Generate commands - default implementation
-     * Creates command files in the provider's directory
+     * Creates command files in the integration's directory
      */
     generateCommands(templates: CommandTemplate[]): Promise<void>;
     /**
-     * Format command content for this provider
+     * Format command content for this integration
      * Default: return content as-is
-     * Override for provider-specific formatting (frontmatter, placeholders, etc.)
+     * Override for integration-specific formatting (frontmatter, placeholders, etc.)
      */
     protected formatCommand(template: CommandTemplate): string;
     /**
      * Default documentation injection - no-op
-     * Override if provider needs doc injection (like Claude Code)
+     * Override if integration needs doc injection (like Claude Code)
      */
     injectDocumentation(_blocks: ManagedBlock[]): Promise<void>;
     /**

package/dist/core/adapters/base-adapter.js

@@ -2,14 +2,14 @@ import * as path from 'path';
 import { FileSystem } from '../../utils/file-system.js';
 import { IntegrationError } from '../../types/errors.js';
 /**
- * Base adapter class with shared logic for all providers
+ * Base adapter class with shared logic for all integrations
  * Ensures consistency and reduces code duplication
  */
 export class BaseAdapter {
     features;
     /**
      * Determine the target filename for a generated command
-     * Providers can override to customize filename conventions
+     * Integrations can override to customize filename conventions
      */
     getTargetFilename(name) {
         return `${name}${this.fileExtension}`;
@@ -88,7 +88,7 @@ export class BaseAdapter {
     }
     /**
      * Determine if a file is a Clavix-generated command
-     * Override in adapters for provider-specific patterns
+     * Override in adapters for integration-specific patterns
      * @param filename The filename to check
      * @returns true if this is a Clavix-generated command file
      */
@@ -98,7 +98,7 @@ export class BaseAdapter {
     }
     /**
      * Generate commands - default implementation
-     * Creates command files in the provider's directory
+     * Creates command files in the integration's directory
      */
     async generateCommands(templates) {
         const commandPath = this.getCommandPath();
@@ -118,16 +118,16 @@ export class BaseAdapter {
         }
     }
     /**
-     * Format command content for this provider
+     * Format command content for this integration
      * Default: return content as-is
-     * Override for provider-specific formatting (frontmatter, placeholders, etc.)
+     * Override for integration-specific formatting (frontmatter, placeholders, etc.)
      */
     formatCommand(template) {
         return template.content;
     }
     /**
      * Default documentation injection - no-op
-     * Override if provider needs doc injection (like Claude Code)
+     * Override if integration needs doc injection (like Claude Code)
      */
     async injectDocumentation(_blocks) {
         // Default: no documentation injection

package/dist/templates/agents/agents.md

@@ -11,7 +11,7 @@ Use these instructions when your agent can only read documentation (no slash-com
 
 | Command | Purpose |
 | --- | --- |
-| `clavix init` | Interactive setup. Select providers and generate documentation/command files. |
+| `clavix init` | Interactive setup. Select integrations and generate documentation/command files. |
 | `clavix fast "<prompt>"` | Quick prompt optimization with quality assessment (Clarity, Efficiency, Structure, Completeness, Actionability). CLI auto-saves to `.clavix/outputs/prompts/fast/`. When using slash commands, agent must save manually per template instructions. |
 | `clavix deep "<prompt>"` | Comprehensive analysis with alternatives, edge cases, and validation checklists. CLI auto-saves to `.clavix/outputs/prompts/deep/`. When using slash commands, agent must save manually per template instructions. |
 | `clavix execute [--latest]` | Execute saved prompts from fast/deep optimization. Interactive selection or `--latest` for most recent. |

package/dist/templates/agents/octo.md

@@ -267,7 +267,7 @@ When starting implementation with `clavix implement`:
 
 | Command | Use it for |
 | --- | --- |
-| `clavix init` | Rebuild `.clavix` structure and regenerate provider assets. |
+| `clavix init` | Rebuild `.clavix` structure and regenerate integration assets. |
 | `clavix fast` / `clavix deep` | Quality-based prompt improvement (quick vs. comprehensive). CLI auto-saves prompts. Slash commands require manual saving per template instructions. |
 | `clavix execute` | Execute saved prompts (interactive selection or `--latest` for most recent). |
 | `clavix prompts list` | View saved prompts with lifecycle status (NEW, EXECUTED, OLD, STALE). |

package/dist/templates/agents/warp.md

@@ -8,7 +8,7 @@ Clavix helps Warp developers turn rough ideas into quality, AI-ready prompts and
 - Verify setup: `clavix version`
 
 ### Common commands
-- `clavix init` – interactive provider setup (regenerates docs & commands)
+- `clavix init` – interactive integration setup (regenerates docs & commands)
 - `clavix fast "<prompt>"` – quick quality assessment (5 dimensions) and improved prompt. CLI auto-saves; slash commands need manual saving per template instructions.
 - `clavix deep "<prompt>"` – comprehensive analysis with alternatives, edge cases, and validation checklists. CLI auto-saves; slash commands need manual saving per template instructions.
 - `clavix execute [--latest]` – execute saved prompts from fast/deep. Interactive selection or `--latest` for most recent.

package/dist/types/agent.d.ts

@@ -6,7 +6,7 @@ export interface AgentAdapter {
     displayName: string;
     directory: string;
     fileExtension: string;
-    features?: ProviderFeatures;
+    features?: IntegrationFeatures;
     detectProject(): Promise<boolean>;
     generateCommands(templates: CommandTemplate[]): Promise<void>;
     removeAllCommands(): Promise<number>;
@@ -15,13 +15,17 @@ export interface AgentAdapter {
     getTargetFilename(name: string): string;
     validate?(): Promise<ValidationResult>;
 }
-export interface ProviderFeatures {
+export interface IntegrationFeatures {
     supportsFrontmatter?: boolean;
     supportsExecutableCommands?: boolean;
     supportsSubdirectories?: boolean;
     argumentPlaceholder?: string;
     frontmatterFields?: string[];
 }
+/**
+ * @deprecated Use IntegrationFeatures instead. Will be removed in v4.0.0
+ */
+export type ProviderFeatures = IntegrationFeatures;
 export interface ValidationResult {
     valid: boolean;
     errors?: string[];

package/dist/types/config.d.ts

@@ -3,18 +3,22 @@
  */
 export interface ClavixConfig {
     version: string;
-    providers: string[];
+    integrations: string[];
     templates: TemplateConfig;
     outputs: OutputConfig;
     preferences: PreferencesConfig;
     experimental?: Record<string, unknown>;
 }
 /**
- * Legacy config format from v1.3.0 and earlier
+ * Legacy config format (pre-v3.5.0)
+ * Supports migration from:
+ * - v1.3.0 and earlier (single 'agent')
+ * - v1.4.0 to v3.4.x ('providers')
  */
 export interface LegacyConfig {
     version: string;
-    agent: string;
+    agent?: string;
+    providers?: string[];
     templates: TemplateConfig;
     outputs: OutputConfig;
     preferences: PreferencesConfig;
@@ -36,11 +40,14 @@ export interface PreferencesConfig {
 }
 export declare const DEFAULT_CONFIG: ClavixConfig;
 /**
- * Migrate legacy config (v1.3.0 and earlier) to new format
+ * Migrate legacy config to current format (v3.5.0+)
+ * Handles migration from:
+ * - v1.3.0 and earlier (single 'agent' field)
+ * - v1.4.0 to v3.4.x ('providers' field)
  */
 export declare function migrateConfig(legacy: LegacyConfig): ClavixConfig;
 /**
- * Check if config is legacy format
+ * Check if config is legacy format (pre-v3.5.0)
  */
 export declare function isLegacyConfig(config: unknown): config is LegacyConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/types/config.js

@@ -2,8 +2,8 @@
  * Configuration types for Clavix
  */
 export const DEFAULT_CONFIG = {
-    version: '1.4.0',
-    providers: [],
+    version: '3.5.0',
+    integrations: [],
     templates: {
         prdQuestions: 'default',
         fullPrd: 'default',
@@ -20,12 +20,29 @@ export const DEFAULT_CONFIG = {
     },
 };
 /**
- * Migrate legacy config (v1.3.0 and earlier) to new format
+ * Migrate legacy config to current format (v3.5.0+)
+ * Handles migration from:
+ * - v1.3.0 and earlier (single 'agent' field)
+ * - v1.4.0 to v3.4.x ('providers' field)
  */
 export function migrateConfig(legacy) {
+    // Determine which legacy format we're migrating from
+    let integrations;
+    if (legacy.providers) {
+        // Migration from v1.4.0-v3.4.x (providers → integrations)
+        integrations = legacy.providers;
+    }
+    else if (legacy.agent) {
+        // Migration from v1.3.0 and earlier (agent → integrations)
+        integrations = [legacy.agent];
+    }
+    else {
+        // Fallback: empty integrations
+        integrations = [];
+    }
     return {
-        version: '1.4.0',
-        providers: [legacy.agent],
+        version: '3.5.0',
+        integrations,
         templates: legacy.templates,
         outputs: legacy.outputs,
         preferences: legacy.preferences,
@@ -33,14 +50,14 @@ export function migrateConfig(legacy) {
     };
 }
 /**
- * Check if config is legacy format
+ * Check if config is legacy format (pre-v3.5.0)
  */
 export function isLegacyConfig(config) {
     return (config !== null &&
         config !== undefined &&
         typeof config === 'object' &&
-        'agent' in config &&
-        typeof config.agent === 'string' &&
-        !('providers' in config));
+        (('agent' in config && typeof config.agent === 'string') ||
+            ('providers' in config && Array.isArray(config.providers))) &&
+        !('integrations' in config));
 }
 //# sourceMappingURL=config.js.map

package/dist/utils/integration-selector.d.ts

@@ -0,0 +1,8 @@
+import { AgentManager } from '../core/agent-manager.js';
+/**
+ * Interactive integration selection utility
+ * Displays multi-select checkbox for all available integrations
+ * Used by both init and config commands
+ */
+export declare function selectIntegrations(agentManager: AgentManager, preSelected?: string[]): Promise<string[]>;
+//# sourceMappingURL=integration-selector.d.ts.map

package/dist/utils/integration-selector.js

@@ -0,0 +1,60 @@
+import inquirer from 'inquirer';
+/**
+ * Interactive integration selection utility
+ * Displays multi-select checkbox for all available integrations
+ * Used by both init and config commands
+ */
+export async function selectIntegrations(agentManager, preSelected = []) {
+    const { selectedIntegrations } = await inquirer.prompt([
+        {
+            type: 'checkbox',
+            name: 'selectedIntegrations',
+            message: 'Which AI tools are you using?',
+            choices: [
+                new inquirer.Separator('=== CLI Tools ==='),
+                { name: 'Amp (.agents/commands/)', value: 'amp' },
+                { name: 'Augment CLI (.augment/commands/clavix/)', value: 'augment' },
+                { name: 'Claude Code (.claude/commands/clavix/)', value: 'claude-code' },
+                { name: 'CodeBuddy CLI (.codebuddy/prompts/)', value: 'codebuddy' },
+                { name: 'Codex CLI (~/.codex/prompts)', value: 'codex' },
+                { name: 'Crush CLI (crush://prompts)', value: 'crush' },
+                { name: 'Droid CLI (.droid/clavix/)', value: 'droid' },
+                { name: 'Gemini CLI (.gemini/commands/clavix/)', value: 'gemini' },
+                { name: 'LLXPRT (~/.llxprt/clavix/)', value: 'llxprt' },
+                { name: 'OpenCode (.opencode/clavix/)', value: 'opencode' },
+                { name: 'Qwen Code (~/.qwen/commands/clavix/)', value: 'qwen' },
+                new inquirer.Separator(),
+                new inquirer.Separator('=== IDE & IDE Extensions ==='),
+                { name: 'Cline (.cline/workflows/)', value: 'cline' },
+                { name: 'Cursor (.cursor/commands/)', value: 'cursor' },
+                { name: 'Kilocode (.kilo/clavix/)', value: 'kilocode' },
+                { name: 'Roocode (.roo/clavix/)', value: 'roocode' },
+                { name: 'Windsurf (.windsurf/rules/)', value: 'windsurf' },
+                new inquirer.Separator(),
+                new inquirer.Separator('=== Universal Adapters ==='),
+                { name: 'AGENTS.md (Universal)', value: 'agents-md' },
+                { name: 'GitHub Copilot (.github/copilot-instructions.md)', value: 'copilot-instructions' },
+                { name: 'OCTO.md (Universal)', value: 'octo-md' },
+                { name: 'WARP.md (Universal)', value: 'warp-md' },
+            ].map((choice) => {
+                // Keep separators as-is
+                if (choice instanceof inquirer.Separator) {
+                    return choice;
+                }
+                // Add 'checked' property based on preSelected
+                return {
+                    ...choice,
+                    checked: preSelected.includes(choice.value),
+                };
+            }),
+            validate: (answer) => {
+                if (answer.length === 0) {
+                    return 'You must select at least one integration.';
+                }
+                return true;
+            },
+        },
+    ]);
+    return selectedIntegrations;
+}
+//# sourceMappingURL=integration-selector.js.map

package/dist/utils/provider-selector.js

@@ -14,28 +14,28 @@ export async function selectProviders(agentManager, preSelected = []) {
                 new inquirer.Separator('=== CLI Tools ==='),
                 { name: 'Amp (.agents/commands/)', value: 'amp' },
                 { name: 'Augment CLI (.augment/commands/clavix/)', value: 'augment' },
+                { name: 'Claude Code (.claude/commands/clavix/)', value: 'claude-code' },
+                { name: 'CodeBuddy CLI (.codebuddy/prompts/)', value: 'codebuddy' },
                 { name: 'Codex CLI (~/.codex/prompts)', value: 'codex' },
-                { name: 'Droid (.droid/clavix/)', value: 'droid' },
+                { name: 'Crush CLI (crush://prompts)', value: 'crush' },
+                { name: 'Droid CLI (.droid/clavix/)', value: 'droid' },
                 { name: 'Gemini CLI (.gemini/commands/clavix/)', value: 'gemini' },
-                { name: 'Kilocode (.kilo/clavix/)', value: 'kilocode' },
-                { name: 'LLXPRT CLI (.llxprt/clavix/)', value: 'llxprt' },
+                { name: 'LLXPRT (~/.llxprt/clavix/)', value: 'llxprt' },
                 { name: 'OpenCode (.opencode/clavix/)', value: 'opencode' },
-                { name: 'Qwen (通义灵码) (~/.qwen/commands/clavix/)', value: 'qwen' },
-                { name: 'RooCode (.roo/clavix/)', value: 'roocode' },
+                { name: 'Qwen Code (~/.qwen/commands/clavix/)', value: 'qwen' },
                 new inquirer.Separator(),
                 new inquirer.Separator('=== IDE & IDE Extensions ==='),
-                { name: 'Claude Code (.claude/commands/clavix/)', value: 'claude-code' },
                 { name: 'Cline (.cline/workflows/)', value: 'cline' },
-                { name: 'CodeBuddy (.codebuddy/prompts/)', value: 'codebuddy' },
-                { name: 'Copilot Instructions (.github/copilot-instructions.md)', value: 'copilot-instructions' },
-                { name: 'Crush (crush://prompts)', value: 'crush' },
                 { name: 'Cursor (.cursor/commands/)', value: 'cursor' },
+                { name: 'Kilocode (.kilo/clavix/)', value: 'kilocode' },
+                { name: 'Roocode (.roo/clavix/)', value: 'roocode' },
                 { name: 'Windsurf (.windsurf/rules/)', value: 'windsurf' },
                 new inquirer.Separator(),
                 new inquirer.Separator('=== Universal Adapters ==='),
-                { name: 'Agents (AGENTS.md - Universal)', value: 'agents-md' },
-                { name: 'Octo (OCTO.md - Universal)', value: 'octo-md' },
-                { name: 'Custom (custom/ directory)', value: 'custom' },
+                { name: 'AGENTS.md (Universal)', value: 'agents-md' },
+                { name: 'GitHub Copilot (.github/copilot-instructions.md)', value: 'copilot-instructions' },
+                { name: 'OCTO.md (Universal)', value: 'octo-md' },
+                { name: 'WARP.md (Universal)', value: 'warp-md' },
             ].map((choice) => {
                 // Keep separators as-is
                 if (choice instanceof inquirer.Separator) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "3.3.2",
+  "version": "3.5.0",
   "description": "Clavix Intelligence™ for AI coding. Automatically optimizes prompts with intent detection, quality assessment, and adaptive patterns—no framework to learn. Works with Claude Code, Cursor, Windsurf, and 19+ other AI coding tools.",
   "type": "module",
   "main": "dist/index.js",