claude-code-templates 1.17.1 → 1.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-templates",
-  "version": "1.17.1",
+  "version": "1.19.0",
   "description": "CLI tool to setup Claude Code configurations with framework-specific commands, automation hooks and MCP Servers for your projects",
   "main": "src/index.js",
   "bin": {

package/src/index.js

@@ -586,115 +586,229 @@ async function installIndividualSetting(settingName, targetDir, options) {
       delete settingConfig.description;
     }
     
-    // Check if .claude/settings.json exists in target directory
-    const claudeDir = path.join(targetDir, '.claude');
-    const targetSettingsFile = path.join(claudeDir, 'settings.json');
-    let existingConfig = {};
-    
-    // Ensure .claude directory exists
-    await fs.ensureDir(claudeDir);
-    
-    if (await fs.pathExists(targetSettingsFile)) {
-      existingConfig = await fs.readJson(targetSettingsFile);
-      console.log(chalk.yellow('📝 Existing .claude/settings.json found, merging configurations...'));
-    }
-    
-    // Check for conflicts before merging
-    const conflicts = [];
-    
-    // Check for conflicting environment variables
-    if (existingConfig.env && settingConfig.env) {
-      Object.keys(settingConfig.env).forEach(key => {
-        if (existingConfig.env[key] && existingConfig.env[key] !== settingConfig.env[key]) {
-          conflicts.push(`Environment variable "${key}" (current: "${existingConfig.env[key]}", new: "${settingConfig.env[key]}")`);
+    // Use shared locations if provided (batch mode), otherwise ask user
+    let installLocations = options.sharedInstallLocations || ['local']; // default to local settings
+    if (!options.silent && !options.sharedInstallLocations) {
+      const inquirer = require('inquirer');
+      const { selectedLocations } = await inquirer.prompt([{
+        type: 'checkbox',
+        name: 'selectedLocations',
+        message: 'Where would you like to install this setting? (Select one or more)',
+        choices: [
+          {
+            name: '🏠 User settings (~/.claude/settings.json) - Applies to all projects',
+            value: 'user'
+          },
+          {
+            name: '📁 Project settings (.claude/settings.json) - Shared with team',
+            value: 'project'
+          },
+          {
+            name: '⚙️  Local settings (.claude/settings.local.json) - Personal, not committed',
+            value: 'local',
+            checked: true // Default selection
+          },
+          {
+            name: '🏢 Enterprise managed settings - System-wide policy (requires admin)',
+            value: 'enterprise'
+          }
+        ],
+        validate: function(answer) {
+          if (answer.length < 1) {
+            return 'You must choose at least one installation location.';
+          }
+          return true;
         }
-      });
+      }]);
+      
+      installLocations = selectedLocations;
     }
     
-    // Check for conflicting top-level settings
-    Object.keys(settingConfig).forEach(key => {
-      if (key !== 'permissions' && key !== 'env' && key !== 'hooks' && 
-          existingConfig[key] !== undefined && existingConfig[key] !== settingConfig[key]) {
-        conflicts.push(`Setting "${key}" (current: "${existingConfig[key]}", new: "${settingConfig[key]}")`);
+    // Install the setting in each selected location
+    let successfulInstallations = 0;
+    for (const installLocation of installLocations) {
+      console.log(chalk.blue(`\n📍 Installing "${settingName}" in ${installLocation} settings...`));
+      
+      let currentTargetDir = targetDir;
+      let settingsFile = 'settings.local.json'; // default
+      
+      if (installLocation === 'user') {
+        const os = require('os');
+        currentTargetDir = os.homedir();
+        settingsFile = 'settings.json';
+      } else if (installLocation === 'project') {
+        settingsFile = 'settings.json';
+      } else if (installLocation === 'local') {
+        settingsFile = 'settings.local.json';
+      } else if (installLocation === 'enterprise') {
+        const os = require('os');
+        const platform = os.platform();
+        
+        if (platform === 'darwin') {
+          // macOS
+          currentTargetDir = '/Library/Application Support/ClaudeCode';
+          settingsFile = 'managed-settings.json';
+        } else if (platform === 'linux' || (process.platform === 'win32' && process.env.WSL_DISTRO_NAME)) {
+          // Linux and WSL
+          currentTargetDir = '/etc/claude-code';
+          settingsFile = 'managed-settings.json';
+        } else if (platform === 'win32') {
+          // Windows
+          currentTargetDir = 'C:\\ProgramData\\ClaudeCode';
+          settingsFile = 'managed-settings.json';
+        } else {
+          console.log(chalk.yellow('⚠️  Platform not supported for enterprise settings. Using user settings instead.'));
+          const os = require('os');
+          currentTargetDir = os.homedir();
+          settingsFile = 'settings.json';
+        }
+        
+        console.log(chalk.yellow(`⚠️  Enterprise settings require administrator privileges.`));
+        console.log(chalk.gray(`📍 Target path: ${path.join(currentTargetDir, settingsFile)}`));
       }
-    });
-    
-    // Ask user about conflicts if any exist and not in silent mode
-    if (conflicts.length > 0 && !options.silent) {
-      console.log(chalk.yellow(`\n⚠️  Conflicts detected while installing setting "${settingName}":`));
-      conflicts.forEach(conflict => console.log(chalk.gray(`   • ${conflict}`)));
       
-      const inquirer = require('inquirer');
-      const { shouldOverwrite } = await inquirer.prompt([{
-        type: 'confirm',
-        name: 'shouldOverwrite',
-        message: 'Do you want to overwrite the existing configuration?',
-        default: false
-      }]);
+      // Determine target directory and file based on selection
+      const claudeDir = path.join(currentTargetDir, '.claude');
+      const targetSettingsFile = path.join(claudeDir, settingsFile);
+      let existingConfig = {};
       
-      if (!shouldOverwrite) {
-        console.log(chalk.yellow(`⏹️  Installation of setting "${settingName}" cancelled by user.`));
-        return;
+      // For enterprise settings, create directory structure directly (not under .claude)
+      if (settingsFile === 'managed-settings.json') {
+        // Ensure enterprise directory exists (requires admin privileges)
+        try {
+          await fs.ensureDir(currentTargetDir);
+        } catch (error) {
+          console.log(chalk.red(`❌ Failed to create enterprise directory: ${error.message}`));
+          console.log(chalk.yellow('💡 Try running with administrator privileges or choose a different installation location.'));
+          continue; // Skip this location and continue with others
+        }
+      } else {
+        // Ensure .claude directory exists for regular settings
+        await fs.ensureDir(claudeDir);
       }
-    } else if (conflicts.length > 0 && options.silent) {
-      // In silent mode (batch installation), skip conflicting settings and warn
-      console.log(chalk.yellow(`⚠️  Skipping setting "${settingName}" due to conflicts (use individual installation to resolve)`));
-      return;
-    }
-    
-    // Deep merge configurations
-    const mergedConfig = {
-      ...existingConfig,
-      ...settingConfig
-    };
-    
-    // Deep merge specific sections (only if no conflicts or user approved overwrite)
-    if (existingConfig.permissions && settingConfig.permissions) {
-      mergedConfig.permissions = {
-        ...existingConfig.permissions,
-        ...settingConfig.permissions
-      };
       
-      // Merge arrays for allow, deny, ask (no conflicts here, just merge)
-      ['allow', 'deny', 'ask'].forEach(key => {
-        if (existingConfig.permissions[key] && settingConfig.permissions[key]) {
-          mergedConfig.permissions[key] = [
-            ...new Set([...existingConfig.permissions[key], ...settingConfig.permissions[key]])
-          ];
+      // Read existing configuration
+      const actualTargetFile = settingsFile === 'managed-settings.json' 
+        ? path.join(currentTargetDir, settingsFile)
+        : targetSettingsFile;
+        
+      if (await fs.pathExists(actualTargetFile)) {
+        existingConfig = await fs.readJson(actualTargetFile);
+        console.log(chalk.yellow(`📝 Existing ${settingsFile} found, merging configurations...`));
+      }
+      
+      // Check for conflicts before merging
+      const conflicts = [];
+      
+      // Check for conflicting environment variables
+      if (existingConfig.env && settingConfig.env) {
+        Object.keys(settingConfig.env).forEach(key => {
+          if (existingConfig.env[key] && existingConfig.env[key] !== settingConfig.env[key]) {
+            conflicts.push(`Environment variable "${key}" (current: "${existingConfig.env[key]}", new: "${settingConfig.env[key]}")`);
+          }
+        });
+      }
+      
+      // Check for conflicting top-level settings
+      Object.keys(settingConfig).forEach(key => {
+        if (key !== 'permissions' && key !== 'env' && key !== 'hooks' && 
+            existingConfig[key] !== undefined && existingConfig[key] !== settingConfig[key]) {
+          conflicts.push(`Setting "${key}" (current: "${existingConfig[key]}", new: "${settingConfig[key]}")`);
         }
       });
-    }
-    
-    if (existingConfig.env && settingConfig.env) {
-      mergedConfig.env = {
-        ...existingConfig.env,
-        ...settingConfig.env
-      };
-    }
-    
-    if (existingConfig.hooks && settingConfig.hooks) {
-      mergedConfig.hooks = {
-        ...existingConfig.hooks,
-        ...settingConfig.hooks
+      
+      // Ask user about conflicts if any exist and not in silent mode
+      if (conflicts.length > 0 && !options.silent) {
+        console.log(chalk.yellow(`\n⚠️  Conflicts detected while installing setting "${settingName}" in ${installLocation}:`));
+        conflicts.forEach(conflict => console.log(chalk.gray(`   • ${conflict}`)));
+        
+        const inquirer = require('inquirer');
+        const { shouldOverwrite } = await inquirer.prompt([{
+          type: 'confirm',
+          name: 'shouldOverwrite',
+          message: `Do you want to overwrite the existing configuration in ${installLocation}?`,
+          default: false
+        }]);
+        
+        if (!shouldOverwrite) {
+          console.log(chalk.yellow(`⏹️  Installation of setting "${settingName}" in ${installLocation} cancelled by user.`));
+          continue; // Skip this location and continue with others
+        }
+      } else if (conflicts.length > 0 && options.silent) {
+        // In silent mode (batch installation), skip conflicting settings and warn
+        console.log(chalk.yellow(`⚠️  Skipping setting "${settingName}" in ${installLocation} due to conflicts (use individual installation to resolve)`));
+        continue; // Skip this location and continue with others
+      }
+      
+      // Deep merge configurations
+      const mergedConfig = {
+        ...existingConfig,
+        ...settingConfig
       };
+      
+      // Deep merge specific sections (only if no conflicts or user approved overwrite)
+      if (existingConfig.permissions && settingConfig.permissions) {
+        mergedConfig.permissions = {
+          ...existingConfig.permissions,
+          ...settingConfig.permissions
+        };
+        
+        // Merge arrays for allow, deny, ask (no conflicts here, just merge)
+        ['allow', 'deny', 'ask'].forEach(key => {
+          if (existingConfig.permissions[key] && settingConfig.permissions[key]) {
+            mergedConfig.permissions[key] = [
+              ...new Set([...existingConfig.permissions[key], ...settingConfig.permissions[key]])
+            ];
+          }
+        });
+      }
+      
+      if (existingConfig.env && settingConfig.env) {
+        mergedConfig.env = {
+          ...existingConfig.env,
+          ...settingConfig.env
+        };
+      }
+      
+      if (existingConfig.hooks && settingConfig.hooks) {
+        mergedConfig.hooks = {
+          ...existingConfig.hooks,
+          ...settingConfig.hooks
+        };
+      }
+      
+      // Write the merged configuration
+      await fs.writeJson(actualTargetFile, mergedConfig, { spaces: 2 });
+      
+      if (!options.silent) {
+        console.log(chalk.green(`✅ Setting "${settingName}" installed successfully in ${installLocation}!`));
+        console.log(chalk.cyan(`📁 Configuration merged into: ${actualTargetFile}`));
+        console.log(chalk.cyan(`📦 Downloaded from: ${githubUrl}`));
+      }
+      
+      // Track successful setting installation for this location
+      trackingService.trackDownload('setting', settingName, {
+        installation_type: 'individual_setting',
+        installation_location: installLocation,
+        merged_with_existing: Object.keys(existingConfig).length > 0,
+        source: 'github_main'
+      });
+      
+      // Increment successful installations counter
+      successfulInstallations++;
     }
     
-    // Write the merged configuration
-    await fs.writeJson(targetSettingsFile, mergedConfig, { spaces: 2 });
-    
+    // Summary after all installations
     if (!options.silent) {
-      console.log(chalk.green(`✅ Setting "${settingName}" installed successfully!`));
-      console.log(chalk.cyan(`📁 Configuration merged into: ${path.relative(targetDir, targetSettingsFile)}`));
-      console.log(chalk.cyan(`📦 Downloaded from: ${githubUrl}`));
+      if (successfulInstallations === installLocations.length) {
+        console.log(chalk.green(`\n🎉 Setting "${settingName}" successfully installed in ${successfulInstallations} location(s)!`));
+      } else {
+        console.log(chalk.yellow(`\n⚠️  Setting "${settingName}" installed in ${successfulInstallations} of ${installLocations.length} location(s).`));
+        const failedCount = installLocations.length - successfulInstallations;
+        console.log(chalk.red(`❌ ${failedCount} installation(s) failed due to permission or other errors.`));
+      }
     }
     
-    // Track successful setting installation
-    trackingService.trackDownload('setting', settingName, {
-      installation_type: 'individual_setting',
-      merged_with_existing: Object.keys(existingConfig).length > 0,
-      source: 'github_main'
-    });
-    
   } catch (error) {
     console.log(chalk.red(`❌ Error installing setting: ${error.message}`));
   }
@@ -734,110 +848,224 @@ async function installIndividualHook(hookName, targetDir, options) {
       delete hookConfig.description;
     }
     
-    // Check if .claude/settings.json exists in target directory (hooks go in settings.json)
-    const claudeDir = path.join(targetDir, '.claude');
-    const targetSettingsFile = path.join(claudeDir, 'settings.json');
-    let existingConfig = {};
-    
-    // Ensure .claude directory exists
-    await fs.ensureDir(claudeDir);
-    
-    if (await fs.pathExists(targetSettingsFile)) {
-      existingConfig = await fs.readJson(targetSettingsFile);
-      console.log(chalk.yellow('📝 Existing .claude/settings.json found, merging hook configurations...'));
-    }
-    
-    // Check for conflicts before merging (simplified for new array format)
-    const conflicts = [];
-    
-    // For the new array format, we'll allow appending rather than conflict detection
-    // This is because Claude Code's array format naturally supports multiple hooks
-    // Conflicts are less likely and generally hooks can coexist
-    
-    // Ask user about conflicts if any exist and not in silent mode
-    if (conflicts.length > 0 && !options.silent) {
-      console.log(chalk.yellow(`\n⚠️  Conflicts detected while installing hook "${hookName}":`));
-      conflicts.forEach(conflict => console.log(chalk.gray(`   • ${conflict}`)));
-      
+    // Use shared locations if provided (batch mode), otherwise ask user
+    let installLocations = options.sharedInstallLocations || ['local']; // default to local settings
+    if (!options.silent && !options.sharedInstallLocations) {
       const inquirer = require('inquirer');
-      const { shouldOverwrite } = await inquirer.prompt([{
-        type: 'confirm',
-        name: 'shouldOverwrite',
-        message: 'Do you want to overwrite the existing hook configuration?',
-        default: false
+      const { selectedLocations } = await inquirer.prompt([{
+        type: 'checkbox',
+        name: 'selectedLocations',
+        message: 'Where would you like to install this hook? (Select one or more)',
+        choices: [
+          {
+            name: '🏠 User settings (~/.claude/settings.json) - Applies to all projects',
+            value: 'user'
+          },
+          {
+            name: '📁 Project settings (.claude/settings.json) - Shared with team',
+            value: 'project'
+          },
+          {
+            name: '⚙️  Local settings (.claude/settings.local.json) - Personal, not committed',
+            value: 'local',
+            checked: true // Default selection
+          },
+          {
+            name: '🏢 Enterprise managed settings - System-wide policy (requires admin)',
+            value: 'enterprise'
+          }
+        ],
+        validate: function(answer) {
+          if (answer.length < 1) {
+            return 'You must choose at least one installation location.';
+          }
+          return true;
+        }
       }]);
       
-      if (!shouldOverwrite) {
-        console.log(chalk.yellow(`⏹️  Installation of hook "${hookName}" cancelled by user.`));
-        return;
-      }
-    } else if (conflicts.length > 0 && options.silent) {
-      // In silent mode (batch installation), skip conflicting hooks and warn
-      console.log(chalk.yellow(`⚠️  Skipping hook "${hookName}" due to conflicts (use individual installation to resolve)`));
-      return;
-    }
-    
-    // Deep merge configurations with proper hook array structure
-    const mergedConfig = {
-      ...existingConfig
-    };
-    
-    // Initialize hooks structure if it doesn't exist
-    if (!mergedConfig.hooks) {
-      mergedConfig.hooks = {};
+      installLocations = selectedLocations;
     }
     
-    // Merge hook configurations properly (Claude Code expects arrays)
-    if (hookConfig.hooks) {
-      Object.keys(hookConfig.hooks).forEach(hookType => {
-        if (!mergedConfig.hooks[hookType]) {
-          // If hook type doesn't exist, just copy the array
-          mergedConfig.hooks[hookType] = hookConfig.hooks[hookType];
+    // Install the hook in each selected location
+    let successfulInstallations = 0;
+    for (const installLocation of installLocations) {
+      console.log(chalk.blue(`\n📍 Installing "${hookName}" in ${installLocation} settings...`));
+      
+      let currentTargetDir = targetDir;
+      let settingsFile = 'settings.local.json'; // default
+
+      if (installLocation === 'user') {
+        const os = require('os');
+        currentTargetDir = os.homedir();
+        settingsFile = 'settings.json';
+      } else if (installLocation === 'project') {
+        settingsFile = 'settings.json';
+      } else if (installLocation === 'local') {
+        settingsFile = 'settings.local.json';
+      } else if (installLocation === 'enterprise') {
+        const os = require('os');
+        const platform = os.platform();
+        
+        if (platform === 'darwin') {
+          // macOS
+          currentTargetDir = '/Library/Application Support/ClaudeCode';
+          settingsFile = 'managed-settings.json';
+        } else if (platform === 'linux' || (process.platform === 'win32' && process.env.WSL_DISTRO_NAME)) {
+          // Linux and WSL
+          currentTargetDir = '/etc/claude-code';
+          settingsFile = 'managed-settings.json';
+        } else if (platform === 'win32') {
+          // Windows
+          currentTargetDir = 'C:\\ProgramData\\ClaudeCode';
+          settingsFile = 'managed-settings.json';
         } else {
-          // If hook type exists, append to the array (Claude Code format)
-          if (Array.isArray(hookConfig.hooks[hookType])) {
-            // New format: array of hook objects
-            if (!Array.isArray(mergedConfig.hooks[hookType])) {
-              // Convert old format to new format
-              mergedConfig.hooks[hookType] = [];
-            }
-            // Append new hooks to existing array
-            mergedConfig.hooks[hookType] = mergedConfig.hooks[hookType].concat(hookConfig.hooks[hookType]);
+          console.log(chalk.yellow('⚠️  Platform not supported for enterprise settings. Using user settings instead.'));
+          const os = require('os');
+          currentTargetDir = os.homedir();
+          settingsFile = 'settings.json';
+        }
+        
+        console.log(chalk.yellow(`⚠️  Enterprise settings require administrator privileges.`));
+        console.log(chalk.gray(`📍 Target path: ${path.join(currentTargetDir, settingsFile)}`));
+      }
+      
+      // Determine target directory and file based on selection
+      const claudeDir = path.join(currentTargetDir, '.claude');
+      const targetSettingsFile = path.join(claudeDir, settingsFile);
+      let existingConfig = {};
+      
+      // For enterprise settings, create directory structure directly (not under .claude)
+      if (settingsFile === 'managed-settings.json') {
+        // Ensure enterprise directory exists (requires admin privileges)
+        try {
+          await fs.ensureDir(currentTargetDir);
+        } catch (error) {
+          console.log(chalk.red(`❌ Failed to create enterprise directory: ${error.message}`));
+          console.log(chalk.yellow('💡 Try running with administrator privileges or choose a different installation location.'));
+          continue; // Skip this location and continue with others
+        }
+      } else {
+        // Ensure .claude directory exists for regular settings
+        await fs.ensureDir(claudeDir);
+      }
+      
+      // Read existing configuration
+      const actualTargetFile = settingsFile === 'managed-settings.json' 
+        ? path.join(currentTargetDir, settingsFile)
+        : targetSettingsFile;
+        
+      if (await fs.pathExists(actualTargetFile)) {
+        existingConfig = await fs.readJson(actualTargetFile);
+        console.log(chalk.yellow(`📝 Existing ${settingsFile} found, merging hook configurations...`));
+      }
+      
+      // Check for conflicts before merging (simplified for new array format)
+      const conflicts = [];
+      
+      // For the new array format, we'll allow appending rather than conflict detection
+      // This is because Claude Code's array format naturally supports multiple hooks
+      // Conflicts are less likely and generally hooks can coexist
+      
+      // Ask user about conflicts if any exist and not in silent mode
+      if (conflicts.length > 0 && !options.silent) {
+        console.log(chalk.yellow(`\n⚠️  Conflicts detected while installing hook "${hookName}" in ${installLocation}:`));
+        conflicts.forEach(conflict => console.log(chalk.gray(`   • ${conflict}`)));
+        
+        const inquirer = require('inquirer');
+        const { shouldOverwrite } = await inquirer.prompt([{
+          type: 'confirm',
+          name: 'shouldOverwrite',
+          message: `Do you want to overwrite the existing hook configuration in ${installLocation}?`,
+          default: false
+        }]);
+        
+        if (!shouldOverwrite) {
+          console.log(chalk.yellow(`⏹️  Installation of hook "${hookName}" in ${installLocation} cancelled by user.`));
+          continue; // Skip this location and continue with others
+        }
+      } else if (conflicts.length > 0 && options.silent) {
+        // In silent mode (batch installation), skip conflicting hooks and warn
+        console.log(chalk.yellow(`⚠️  Skipping hook "${hookName}" in ${installLocation} due to conflicts (use individual installation to resolve)`));
+        continue; // Skip this location and continue with others
+      }
+      
+      // Deep merge configurations with proper hook array structure
+      const mergedConfig = {
+        ...existingConfig
+      };
+      
+      // Initialize hooks structure if it doesn't exist
+      if (!mergedConfig.hooks) {
+        mergedConfig.hooks = {};
+      }
+      
+      // Merge hook configurations properly (Claude Code expects arrays)
+      if (hookConfig.hooks) {
+        Object.keys(hookConfig.hooks).forEach(hookType => {
+          if (!mergedConfig.hooks[hookType]) {
+            // If hook type doesn't exist, just copy the array
+            mergedConfig.hooks[hookType] = hookConfig.hooks[hookType];
           } else {
-            // Old format compatibility: convert to new format
-            console.log(chalk.yellow(`⚠️  Converting old hook format to new Claude Code format for ${hookType}`));
-            if (!Array.isArray(mergedConfig.hooks[hookType])) {
-              mergedConfig.hooks[hookType] = [];
+            // If hook type exists, append to the array (Claude Code format)
+            if (Array.isArray(hookConfig.hooks[hookType])) {
+              // New format: array of hook objects
+              if (!Array.isArray(mergedConfig.hooks[hookType])) {
+                // Convert old format to new format
+                mergedConfig.hooks[hookType] = [];
+              }
+              // Append new hooks to existing array
+              mergedConfig.hooks[hookType] = mergedConfig.hooks[hookType].concat(hookConfig.hooks[hookType]);
+            } else {
+              // Old format compatibility: convert to new format
+              console.log(chalk.yellow(`⚠️  Converting old hook format to new Claude Code format for ${hookType}`));
+              if (!Array.isArray(mergedConfig.hooks[hookType])) {
+                mergedConfig.hooks[hookType] = [];
+              }
+              // Add old format hook as a single matcher
+              mergedConfig.hooks[hookType].push({
+                matcher: "*",
+                hooks: [{
+                  type: "command",
+                  command: hookConfig.hooks[hookType]
+                }]
+              });
             }
-            // Add old format hook as a single matcher
-            mergedConfig.hooks[hookType].push({
-              matcher: "*",
-              hooks: [{
-                type: "command",
-                command: hookConfig.hooks[hookType]
-              }]
-            });
           }
-        }
+        });
+      }
+      
+      // Write the merged configuration
+      await fs.writeJson(actualTargetFile, mergedConfig, { spaces: 2 });
+      
+      if (!options.silent) {
+        console.log(chalk.green(`✅ Hook "${hookName}" installed successfully in ${installLocation}!`));
+        console.log(chalk.cyan(`📁 Configuration merged into: ${actualTargetFile}`));
+        console.log(chalk.cyan(`📦 Downloaded from: ${githubUrl}`));
+      }
+      
+      // Track successful hook installation for this location
+      trackingService.trackDownload('hook', hookName, {
+        installation_type: 'individual_hook',
+        installation_location: installLocation,
+        merged_with_existing: Object.keys(existingConfig).length > 0,
+        source: 'github_main'
       });
+      
+      // Increment successful installations counter
+      successfulInstallations++;
     }
     
-    // Write the merged configuration
-    await fs.writeJson(targetSettingsFile, mergedConfig, { spaces: 2 });
-    
+    // Summary after all installations
     if (!options.silent) {
-      console.log(chalk.green(`✅ Hook "${hookName}" installed successfully!`));
-      console.log(chalk.cyan(`📁 Configuration merged into: ${path.relative(targetDir, targetSettingsFile)}`));
-      console.log(chalk.cyan(`📦 Downloaded from: ${githubUrl}`));
+      if (successfulInstallations === installLocations.length) {
+        console.log(chalk.green(`\n🎉 Hook "${hookName}" successfully installed in ${successfulInstallations} location(s)!`));
+      } else {
+        console.log(chalk.yellow(`\n⚠️  Hook "${hookName}" installed in ${successfulInstallations} of ${installLocations.length} location(s).`));
+        const failedCount = installLocations.length - successfulInstallations;
+        console.log(chalk.red(`❌ ${failedCount} installation(s) failed due to permission or other errors.`));
+      }
     }
     
-    // Track successful hook installation
-    trackingService.trackDownload('hook', hookName, {
-      installation_type: 'individual_hook',
-      merged_with_existing: Object.keys(existingConfig).length > 0,
-      source: 'github_main'
-    });
-    
   } catch (error) {
     console.log(chalk.red(`❌ Error installing hook: ${error.message}`));
   }
@@ -980,6 +1208,48 @@ async function installMultipleComponents(options, targetDir) {
     console.log(chalk.gray(`   Settings: ${components.settings.length}`));
     console.log(chalk.gray(`   Hooks: ${components.hooks.length}`));
     
+    // Ask for installation locations once for configuration components (if any exist and not in silent mode)
+    let sharedInstallLocations = ['local']; // default
+    const hasSettingsOrHooks = components.settings.length > 0 || components.hooks.length > 0;
+    
+    if (hasSettingsOrHooks && !options.yes) {
+      console.log(chalk.blue('\n📍 Choose installation locations for configuration components:'));
+      const inquirer = require('inquirer');
+      const { selectedLocations } = await inquirer.prompt([{
+        type: 'checkbox',
+        name: 'selectedLocations',
+        message: 'Where would you like to install the configuration components? (Select one or more)',
+        choices: [
+          {
+            name: '🏠 User settings (~/.claude/settings.json) - Applies to all projects',
+            value: 'user'
+          },
+          {
+            name: '📁 Project settings (.claude/settings.json) - Shared with team',
+            value: 'project'
+          },
+          {
+            name: '⚙️  Local settings (.claude/settings.local.json) - Personal, not committed',
+            value: 'local',
+            checked: true // Default selection
+          },
+          {
+            name: '🏢 Enterprise managed settings - System-wide policy (requires admin)',
+            value: 'enterprise'
+          }
+        ],
+        validate: function(answer) {
+          if (answer.length < 1) {
+            return 'You must choose at least one installation location.';
+          }
+          return true;
+        }
+      }]);
+      
+      sharedInstallLocations = selectedLocations;
+      console.log(chalk.cyan(`📋 Will install configuration components in: ${sharedInstallLocations.join(', ')}`));
+    }
+    
     // Install agents
     for (const agent of components.agents) {
       console.log(chalk.gray(`   Installing agent: ${agent}`));
@@ -998,16 +1268,24 @@ async function installMultipleComponents(options, targetDir) {
       await installIndividualMCP(mcp, targetDir, { ...options, silent: true });
     }
     
-    // Install settings
+    // Install settings (using shared installation locations)
     for (const setting of components.settings) {
       console.log(chalk.gray(`   Installing setting: ${setting}`));
-      await installIndividualSetting(setting, targetDir, { ...options, silent: true });
+      await installIndividualSetting(setting, targetDir, { 
+        ...options, 
+        silent: true, 
+        sharedInstallLocations: sharedInstallLocations 
+      });
     }
     
-    // Install hooks
+    // Install hooks (using shared installation locations)
     for (const hook of components.hooks) {
       console.log(chalk.gray(`   Installing hook: ${hook}`));
-      await installIndividualHook(hook, targetDir, { ...options, silent: true });
+      await installIndividualHook(hook, targetDir, { 
+        ...options, 
+        silent: true, 
+        sharedInstallLocations: sharedInstallLocations 
+      });
     }
     
     // Handle YAML workflow if provided