claude-git-hooks 1.5.4 → 1.5.5

package/CHANGELOG.md

@@ -5,7 +5,42 @@ Todos los cambios notables en este proyecto se documentarán en este archivo.
 El formato está basado en [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.5.4] - 2024-12-22
+## [1.5.5] - 2025-10-29
+
+### Added
+
+- 🚀 **Parallel Analysis with Subagents**
+  - New `CLAUDE_USE_SUBAGENTS` environment variable to enable parallel file analysis
+  - Each file analyzed by dedicated Claude subagent for faster processing
+  - Works across all analysis functions: pre-commit, message generation, and analyze-diff
+  - Significantly faster for commits with 3+ files
+
+- ⚙️ **Subagent Configuration Options**
+  - `CLAUDE_SUBAGENT_MODEL` - Choose model: haiku (fast), sonnet (balanced), opus (thorough)
+  - `CLAUDE_SUBAGENT_BATCH_SIZE` - Control parallel processing (default: 3 files at once)
+  - Automatic result consolidation across all subagents
+
+- ⏱️ **Execution Time Measurement**
+  - All operations now display execution time in seconds and milliseconds
+  - Pre-commit analysis: Shows time on success and failure
+  - Message generation: Shows generation time
+  - Analyze-diff: Shows analysis time
+  - Helps identify performance improvements and bottlenecks
+
+- 🔧 **Git Worktree Support**
+  - `claude-hooks` now recognizes worktrees created in PowerShell from WSL
+  - Automatically converts Windows paths (C:\) to WSL paths (/mnt/c/)
+  - No more "not a git repository" errors when working in cross-platform worktrees
+
+### Changed
+
+- 📝 Subagent instructions include explicit consolidation logic for consistent results
+- 🎨 Help command updated with batching examples and clarifications
+- 📋 Post-install text now mentions parallel analysis feature with examples
+- ✅ **Batch size validation** - `CLAUDE_SUBAGENT_BATCH_SIZE` now validated (minimum: 1)
+- 📚 Batching behavior explicitly documented with concrete examples
+
+## [1.5.4] - 2025-09-15
 
 ### Fixed
 

package/README.md

@@ -101,6 +101,11 @@ public void methodToIgnore() {
 # Variables de entorno
 export CLAUDE_ANALYSIS_MODE=sonarqube  # Modo de análisis
 export CLAUDE_DEBUG=true               # Debug detallado
+
+# Subagent configuration (parallel analysis for multiple files)
+export CLAUDE_USE_SUBAGENTS=true           # Enable subagent parallel analysis
+export CLAUDE_SUBAGENT_MODEL=haiku         # Model: haiku (fast), sonnet (balanced), opus (thorough)
+export CLAUDE_SUBAGENT_BATCH_SIZE=3        # Parallel subagents per batch (default: 3)
 ```
 
 ### 🎯 Casos de Uso Específicos
@@ -134,6 +139,41 @@ git commit -m "fix: resolver issues"
 5. **Archivos grandes**: Se omiten automáticamente archivos > 100KB
 6. **Límite de archivos**: Máximo 10 archivos por commit
 
+### 🚀 Parallel Analysis with Subagents (NEW in v1.5.5)
+
+**When analyzing 3+ files**, enable subagents for faster parallel processing:
+
+```bash
+# Enable subagent parallel analysis
+export CLAUDE_USE_SUBAGENTS=true
+
+# Optional: Choose model (default: haiku for speed)
+export CLAUDE_SUBAGENT_MODEL=haiku    # Fast & cheap
+export CLAUDE_SUBAGENT_MODEL=sonnet   # Balanced quality/speed
+export CLAUDE_SUBAGENT_MODEL=opus     # Maximum quality
+
+# Optional: Adjust batch size (default: 3 files at a time)
+export CLAUDE_SUBAGENT_BATCH_SIZE=3
+
+# Now commits will use parallel analysis automatically
+git commit -m "feat: implement multiple features"
+```
+
+**How batching works:**
+- `BATCH_SIZE=1` with 4 files → 4 sequential batches (1 subagent each)
+- `BATCH_SIZE=3` with 4 files → 2 batches (3 parallel, then 1)
+- `BATCH_SIZE=4` with 4 files → 1 batch (all 4 in parallel)
+- Batch size is validated automatically (minimum: 1)
+
+**How it works:**
+- Each file is analyzed by a dedicated Claude subagent
+- Files are processed in batches for optimal performance
+- Results are consolidated automatically into single response
+- Shows execution time for all operations
+- Uses one-line prompt injection - no complex architecture changes
+
+**Best for:** Large commits (3+ files), refactoring tasks, feature branches
+
 ## 🔧 Configuración Previa Importante
 
 ### Credenciales Git en WSL

package/bin/claude-hooks

@@ -42,24 +42,24 @@ async function checkVersionAndPromptUpdate() {
   try {
     const currentVersion = require('../package.json').version;
     const latestVersion = await getLatestVersion('claude-git-hooks');
-    
+
     if (currentVersion === latestVersion) {
       return true; // Already updated
     }
-    
+
     console.log('');
     warning(`New version available: ${latestVersion} (current: ${currentVersion})`);
-    
+
     // Interactive prompt compatible with all consoles
     const rl = readline.createInterface({
       input: process.stdin,
       output: process.stdout
     });
-    
+
     return new Promise((resolve) => {
       rl.question('Do you want to update now? (y/n): ', (answer) => {
         rl.close();
-        
+
         if (answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes') {
           info('Updating claude-git-hooks...');
           try {
@@ -124,7 +124,7 @@ function readPassword(prompt) {
       input: process.stdin,
       output: process.stdout
     });
-    
+
     // Disable echo
     rl.stdoutMuted = true;
     rl._writeToOutput = function _writeToOutput(stringToWrite) {
@@ -133,7 +133,7 @@ function readPassword(prompt) {
       else
         rl.output.write(stringToWrite);
     };
-    
+
     rl.question(prompt, (password) => {
       rl.close();
       console.log(); // New line
@@ -145,7 +145,7 @@ function readPassword(prompt) {
 // Check if sudo password is correct
 function testSudoPassword(password) {
   try {
-    execSync('echo "' + password + '" | sudo -S true', { 
+    execSync('echo "' + password + '" | sudo -S true', {
       stdio: 'ignore',
       timeout: 5000
     });
@@ -231,26 +231,26 @@ class Entertainment {
     // Get first joke from API without blocking
     this.getJoke().then(joke => {
       if (!isFinished) currentJoke = joke;
-    }).catch(() => {}); // If it fails, keep the local one
+    }).catch(() => { }); // If it fails, keep the local one
 
     // Hide cursor
     process.stdout.write('\x1B[?25l');
-    
+
     // Reserve space for the 3 lines
     process.stdout.write('\n\n\n');
-    
+
     const interval = setInterval(() => {
       if (isFinished) {
         clearInterval(interval);
         return;
       }
-      
+
       spinnerIndex++;
-      
+
       // Update countdown every second (10 iterations of 100ms)
       if (spinnerIndex % 10 === 0) {
         jokeCountdown--;
-        
+
         // Refresh joke every 10 seconds
         if (jokeCountdown <= 0) {
           this.getJoke().then(joke => {
@@ -263,19 +263,19 @@ class Entertainment {
           jokeCountdown = 10;
         }
       }
-      
+
       // Always go back exactly 3 lines up
       process.stdout.write('\x1B[3A');
-      
+
       // Render the 3 lines from the beginning
       const spinner = spinners[spinnerIndex % spinners.length];
-      
+
       // Line 1: Spinner
       process.stdout.write('\r\x1B[2K' + `${colors.yellow}${spinner} ${message}${colors.reset}\n`);
-      
+
       // Line 2: Joke  
       process.stdout.write('\r\x1B[2K' + `${colors.green}🎭 ${currentJoke}${colors.reset}\n`);
-      
+
       // Line 3: Countdown
       process.stdout.write('\r\x1B[2K' + `${colors.yellow}⏱️  Next joke in: ${jokeCountdown}s${colors.reset}\n`);
     }, 100);
@@ -284,7 +284,7 @@ class Entertainment {
       const result = await promise;
       isFinished = true;
       clearInterval(interval);
-      
+
       // Clean exactly 3 lines completely
       process.stdout.write('\x1B[3A'); // Go up 3 lines
       process.stdout.write('\r\x1B[2K'); // Clean line 1
@@ -292,15 +292,15 @@ class Entertainment {
       process.stdout.write('\n\r\x1B[2K'); // Go down and clean line 3
       process.stdout.write('\x1B[2A'); // Go up 2 lines to end up on the first
       process.stdout.write('\r'); // Go to beginning of line
-      
+
       // Show cursor
       process.stdout.write('\x1B[?25h');
-      
+
       return result;
     } catch (error) {
       isFinished = true;
       clearInterval(interval);
-      
+
       // Clean exactly 3 lines completely
       process.stdout.write('\x1B[3A'); // Go up 3 lines
       process.stdout.write('\r\x1B[2K'); // Clean line 1
@@ -308,21 +308,42 @@ class Entertainment {
       process.stdout.write('\n\r\x1B[2K'); // Go down and clean line 3
       process.stdout.write('\x1B[2A'); // Go up 2 lines to end up on the first
       process.stdout.write('\r'); // Go to beginning of line
-      
+
       // Show cursor
       process.stdout.write('\x1B[?25h');
-      
+
       throw error;
     }
   }
 }
 
-// Check if we are in a git repository
+// Check if we are in a git repository (including worktrees created in PowerShell)
 function checkGitRepo() {
   try {
     execSync('git rev-parse --git-dir', { stdio: 'ignore' });
     return true;
   } catch (e) {
+    // Try to detect worktree created in PowerShell
+    try {
+      if (fs.existsSync('.git')) {
+        const gitContent = fs.readFileSync('.git', 'utf8').trim();
+        // Check if it's a worktree pointer (gitdir: ...)
+        if (gitContent.startsWith('gitdir:')) {
+          let gitdir = gitContent.substring(8).trim();
+          // Convert Windows path to WSL if needed (C:\ -> /mnt/c/)
+          if (/^[A-Za-z]:/.test(gitdir)) {
+            gitdir = gitdir.replace(/^([A-Za-z]):/, (_, drive) => `/mnt/${drive.toLowerCase()}`);
+            gitdir = gitdir.replace(/\\/g, '/');
+          }
+          // Verify the gitdir exists
+          if (fs.existsSync(gitdir)) {
+            return true;
+          }
+        }
+      }
+    } catch (worktreeError) {
+      // Ignore worktree detection errors
+    }
     return false;
   }
 }
@@ -340,7 +361,7 @@ async function install(args) {
 
   const isForce = args.includes('--force');
   const skipAuth = args.includes('--skip-auth');
-  
+
   if (isForce) {
     info('Installing Claude Git Hooks (force mode)...');
   } else {
@@ -354,7 +375,7 @@ async function install(args) {
     if (needsInstall) {
       info('Sudo access is needed for automatic dependency installation, please enter password');
       sudoPassword = await readPassword('Enter your Ubuntu password for sudo: ');
-      
+
       if (sudoPassword && !testSudoPassword(sudoPassword)) {
         warning('Incorrect password. Continuing without automatic installation.');
         sudoPassword = null;
@@ -377,18 +398,18 @@ async function install(args) {
 
   // Hooks to install
   const hooks = ['pre-commit', 'prepare-commit-msg'];
-  
+
   hooks.forEach(hook => {
     const sourcePath = path.join(templatesPath, hook);
     const destPath = path.join(hooksPath, hook);
-    
+
     // Make backup if it exists
     if (fs.existsSync(destPath)) {
       const backupPath = `${destPath}.backup.${Date.now()}`;
       fs.copyFileSync(destPath, backupPath);
       info(`Backup created: ${backupPath}`);
     }
-    
+
     // Copy hook
     fs.copyFileSync(sourcePath, destPath);
     fs.chmodSync(destPath, '755');
@@ -398,7 +419,7 @@ async function install(args) {
   // Copy version verification script
   const checkVersionSource = path.join(templatesPath, 'check-version.sh');
   const checkVersionDest = path.join(hooksPath, 'check-version.sh');
-  
+
   if (fs.existsSync(checkVersionSource)) {
     fs.copyFileSync(checkVersionSource, checkVersionDest);
     fs.chmodSync(checkVersionDest, '755');
@@ -418,11 +439,11 @@ async function install(args) {
     'CLAUDE_ANALYSIS_PROMPT_SONAR.md',
     'CLAUDE_RESOLUTION_PROMPT.md'
   ];
-  
+
   claudeFiles.forEach(file => {
     const destPath = path.join(claudeDir, file);
     const sourcePath = path.join(templatesPath, file);
-    
+
     // In force mode or if it doesn't exist, copy the file
     if (isForce || !fs.existsSync(destPath)) {
       if (fs.existsSync(sourcePath)) {
@@ -450,13 +471,19 @@ async function install(args) {
   console.log('  // SKIP_ANALYSIS_BLOCK  # Exclude block until finding another equal one');
   console.log('  ...excluded code...');
   console.log('  // SKIP_ANALYSIS_BLOCK');
+  console.log('\nNEW: Parallel analysis for faster multi-file commits:');
+  console.log('  export CLAUDE_USE_SUBAGENTS=true       # Enable subagents');
+  console.log('  export CLAUDE_SUBAGENT_MODEL=haiku     # haiku/sonnet/opus');
+  console.log('  export CLAUDE_SUBAGENT_BATCH_SIZE=3    # Parallel per batch (default: 3)');
+  console.log('  # Example: 4 files, BATCH_SIZE=1 → 4 sequential batches');
+  console.log('  # Example: 4 files, BATCH_SIZE=3 → 2 batches (3 parallel + 1)');
   console.log('\nFor more options: claude-hooks --help');
 }
 
 // Check complete dependencies (like setup-wsl.sh)
 async function checkAndInstallDependencies(sudoPassword = null, skipAuth = false) {
   info('Checking system dependencies...');
-  
+
   // Check Node.js
   try {
     const nodeVersion = execSync('node --version', { encoding: 'utf8' }).trim();
@@ -464,7 +491,7 @@ async function checkAndInstallDependencies(sudoPassword = null, skipAuth = false
   } catch (e) {
     error('Node.js is not installed. Install Node.js and try again.');
   }
-  
+
   // Check npm
   try {
     const npmVersion = execSync('npm --version', { encoding: 'utf8' }).trim();
@@ -472,7 +499,7 @@ async function checkAndInstallDependencies(sudoPassword = null, skipAuth = false
   } catch (e) {
     error('npm is not installed.');
   }
-  
+
   // Check and install jq
   try {
     const jqVersion = execSync('jq --version', { encoding: 'utf8' }).trim();
@@ -490,7 +517,7 @@ async function checkAndInstallDependencies(sudoPassword = null, skipAuth = false
       }
     }
   }
-  
+
   // Check and install curl
   try {
     const curlVersion = execSync('curl --version', { encoding: 'utf8' }).split('\n')[0];
@@ -508,7 +535,7 @@ async function checkAndInstallDependencies(sudoPassword = null, skipAuth = false
       }
     }
   }
-  
+
   // Check Git
   try {
     const gitVersion = execSync('git --version', { encoding: 'utf8' }).trim();
@@ -516,11 +543,11 @@ async function checkAndInstallDependencies(sudoPassword = null, skipAuth = false
   } catch (e) {
     error('Git is not installed. Install Git and try again.');
   }
-  
+
   // Check standard Unix tools
   const unixTools = ['sed', 'awk', 'grep', 'head', 'tail', 'stat', 'tput'];
   const missingTools = [];
-  
+
   unixTools.forEach(tool => {
     try {
       execSync(`which ${tool}`, { stdio: 'ignore' });
@@ -528,23 +555,23 @@ async function checkAndInstallDependencies(sudoPassword = null, skipAuth = false
       missingTools.push(tool);
     }
   });
-  
+
   if (missingTools.length === 0) {
     success('Standard Unix tools verified');
   } else {
     error(`Missing standard Unix tools: ${missingTools.join(', ')}. Retry installation in an Ubuntu console`);
   }
-  
+
   // Check and install Claude CLI
   await checkAndInstallClaude();
-  
+
   // Check Claude authentication (if not skipped)
   if (!skipAuth) {
     await checkClaudeAuth();
   } else {
     warning('Skipping Claude authentication verification (--skip-auth)');
   }
-  
+
   // Clear password from memory
   sudoPassword = null;
 }
@@ -552,7 +579,7 @@ async function checkAndInstallDependencies(sudoPassword = null, skipAuth = false
 // Check if we need to install dependencies
 async function checkIfInstallationNeeded() {
   const dependencies = ['jq', 'curl'];
-  
+
   for (const dep of dependencies) {
     try {
       execSync(`which ${dep}`, { stdio: 'ignore' });
@@ -560,14 +587,14 @@ async function checkIfInstallationNeeded() {
       return true; // Needs installation
     }
   }
-  
+
   // Verificar Claude CLI
   try {
     execSync('claude --version', { stdio: 'ignore' });
   } catch (e) {
     return true; // Needs Claude installation
   }
-  
+
   return false;
 }
 
@@ -590,7 +617,7 @@ async function checkAndInstallClaude() {
 // Check Claude authentication with entertainment
 async function checkClaudeAuth() {
   info('Checking Claude authentication...');
-  
+
   // Use spawn to not block, but with stdio: 'ignore' like the original
   const authPromise = new Promise((resolve, reject) => {
     const child = spawn('claude', ['auth', 'status'], {
@@ -598,13 +625,13 @@ async function checkClaudeAuth() {
       detached: false,
       windowsHide: true
     });
-    
+
     // Manual timeout since spawn doesn't have native timeout
     const timeout = setTimeout(() => {
       child.kill();
       reject(new Error('timeout'));
     }, 120000); // 2 minutos
-    
+
     child.on('exit', (code) => {
       clearTimeout(timeout);
       if (code === 0) {
@@ -613,7 +640,7 @@ async function checkClaudeAuth() {
         reject(new Error('not_authenticated'));
       }
     });
-    
+
     child.on('error', (err) => {
       clearTimeout(timeout);
       reject(err);
@@ -633,7 +660,7 @@ async function checkClaudeAuth() {
 // Update .gitignore with Claude entries
 function updateGitignore() {
   info('Updating .gitignore...');
-  
+
   const gitignorePath = '.gitignore';
   const claudeEntries = [
     '# Claude Git Hooks',
@@ -642,16 +669,16 @@ function updateGitignore() {
     'claude_resolution_prompt.md',
     '.claude-pr-analysis.json',
   ];
-  
+
   let gitignoreContent = '';
   let fileExists = false;
-  
+
   // Read existing .gitignore if it exists
   if (fs.existsSync(gitignorePath)) {
     gitignoreContent = fs.readFileSync(gitignorePath, 'utf8');
     fileExists = true;
   }
-  
+
   // Check which entries are missing
   const missingEntries = [];
   claudeEntries.forEach(entry => {
@@ -668,31 +695,31 @@ function updateGitignore() {
       }
     }
   });
-  
+
   // If there are missing entries, add them
   if (missingEntries.length > 0) {
     // Ensure there's a newline at the end if the file exists and is not empty
     if (fileExists && gitignoreContent.length > 0 && !gitignoreContent.endsWith('\n')) {
       gitignoreContent += '\n';
     }
-    
+
     // If the file is not empty, add a blank line before
     if (gitignoreContent.length > 0) {
       gitignoreContent += '\n';
     }
-    
+
     // Add the missing entries
     gitignoreContent += missingEntries.join('\n') + '\n';
-    
+
     // Write the updated file
     fs.writeFileSync(gitignorePath, gitignoreContent);
-    
+
     if (fileExists) {
       success('.gitignore updated with Claude entries');
     } else {
       success('.gitignore created with Claude entries');
     }
-    
+
     // Show what was added
     missingEntries.forEach(entry => {
       if (!entry.startsWith('#')) {
@@ -707,12 +734,12 @@ function updateGitignore() {
 // Configure Git (line endings, etc.)
 function configureGit() {
   info('Configuring Git...');
-  
+
   try {
     // Configure line endings for WSL
     execSync('git config core.autocrlf input', { stdio: 'ignore' });
     success('Line endings configured for WSL (core.autocrlf = input)');
-    
+
     // Try to configure on Windows through PowerShell
     try {
       execSync('powershell.exe -Command "git config core.autocrlf true"', { stdio: 'ignore' });
@@ -720,7 +747,7 @@ function configureGit() {
     } catch (psError) {
       info('Could not configure automatically on Windows');
     }
-    
+
   } catch (e) {
     warning('Error configuring Git');
   }
@@ -736,7 +763,7 @@ function uninstall() {
 
   const hooksPath = '.git/hooks';
   const hooks = ['pre-commit', 'prepare-commit-msg'];
-  
+
   hooks.forEach(hook => {
     const hookPath = path.join(hooksPath, hook);
     if (fs.existsSync(hookPath)) {
@@ -755,11 +782,11 @@ function enable(hookName) {
   }
 
   const hooks = hookName ? [hookName] : ['pre-commit', 'prepare-commit-msg'];
-  
+
   hooks.forEach(hook => {
     const disabledPath = `.git/hooks/${hook}.disabled`;
     const enabledPath = `.git/hooks/${hook}`;
-    
+
     if (fs.existsSync(disabledPath)) {
       fs.renameSync(disabledPath, enabledPath);
       success(`${hook} enabled`);
@@ -778,11 +805,11 @@ function disable(hookName) {
   }
 
   const hooks = hookName ? [hookName] : ['pre-commit', 'prepare-commit-msg'];
-  
+
   hooks.forEach(hook => {
     const enabledPath = `.git/hooks/${hook}`;
     const disabledPath = `.git/hooks/${hook}.disabled`;
-    
+
     if (fs.existsSync(enabledPath)) {
       fs.renameSync(enabledPath, disabledPath);
       success(`${hook} disabled`);
@@ -802,7 +829,7 @@ function analyzeDiff(args) {
   }
 
   const currentBranch = execSync('git branch --show-current', { encoding: 'utf8' }).trim();
-  
+
   if (!currentBranch) {
     error('You are not in a valid branch.');
     return;
@@ -819,7 +846,7 @@ function analyzeDiff(args) {
     baseBranch = `origin/${targetBranch}`;
     compareWith = `${baseBranch}...HEAD`;
     contextDescription = `${currentBranch} vs ${baseBranch}`;
-    
+
     // Check that the origin branch exists
     try {
       execSync(`git rev-parse --verify ${baseBranch}`, { stdio: 'ignore' });
@@ -832,7 +859,7 @@ function analyzeDiff(args) {
     baseBranch = `origin/${currentBranch}`;
     compareWith = `${baseBranch}...HEAD`;
     contextDescription = `${currentBranch} vs ${baseBranch}`;
-    
+
     // Check that the origin branch exists
     try {
       execSync(`git rev-parse --verify ${baseBranch}`, { stdio: 'ignore' });
@@ -841,7 +868,7 @@ function analyzeDiff(args) {
       baseBranch = 'origin/develop';
       compareWith = `${baseBranch}...HEAD`;
       contextDescription = `${currentBranch} vs ${baseBranch} (fallback)`;
-      
+
       try {
         execSync(`git rev-parse --verify ${baseBranch}`, { stdio: 'ignore' });
         warning(`Branch origin/${currentBranch} does not exist. Using ${baseBranch} as fallback.`);
@@ -850,7 +877,7 @@ function analyzeDiff(args) {
         baseBranch = 'origin/main';
         compareWith = `${baseBranch}...HEAD`;
         contextDescription = `${currentBranch} vs ${baseBranch} (fallback)`;
-        
+
         try {
           execSync(`git rev-parse --verify ${baseBranch}`, { stdio: 'ignore' });
           warning(`No origin/develop branch. Using ${baseBranch} as fallback.`);
@@ -868,12 +895,12 @@ function analyzeDiff(args) {
   let diffFiles;
   try {
     diffFiles = execSync(`git diff ${compareWith} --name-only`, { encoding: 'utf8' }).trim();
-    
+
     if (!diffFiles) {
       // Check if there are staged or unstaged changes
       const stagedFiles = execSync('git diff --cached --name-only', { encoding: 'utf8' }).trim();
       const unstagedFiles = execSync('git diff --name-only', { encoding: 'utf8' }).trim();
-      
+
       if (stagedFiles || unstagedFiles) {
         warning('No differences with remote, but you have uncommitted local changes.');
         console.log('Staged changes:', stagedFiles || 'none');
@@ -902,14 +929,26 @@ function analyzeDiff(args) {
     error('Error getting diff or commits: ' + e.message);
     return;
   }
-  
+
   // Create the prompt for Claude
   const tempDir = `/tmp/claude-analyze-${Date.now()}`;
   fs.mkdirSync(tempDir, { recursive: true });
-  
+
+  // Check if subagents should be used
+  const useSubagents = process.env.CLAUDE_USE_SUBAGENTS === 'true';
+  const subagentModel = process.env.CLAUDE_SUBAGENT_MODEL || 'haiku';
+  let subagentBatchSize = parseInt(process.env.CLAUDE_SUBAGENT_BATCH_SIZE || '3');
+  // Validate batch size (must be >= 1)
+  if (subagentBatchSize < 1) {
+    subagentBatchSize = 1;
+  }
+  const subagentInstruction = useSubagents
+    ? `\n\nIMPORTANT PARALLEL PROCESSING: If analyzing 3+ files, process them in batches of ${subagentBatchSize}. For EACH batch, create that many subagents in parallel using Task tool (send single message with multiple Task calls). Each subagent analyzes one file and provides insights. After ALL batches complete, consolidate into SINGLE JSON with ONE cohesive PR title/description. Model: ${subagentModel}. Example: 4 files with BATCH_SIZE=1 → 4 sequential batches of 1 subagent each. Example: 4 files with BATCH_SIZE=3 → batch 1 has 3 parallel subagents (files 1-3), batch 2 has 1 subagent (file 4).\n`
+    : '';
+
   const promptFile = path.join(tempDir, 'prompt.txt');
   const prompt = `Analyze the following changes. CONTEXT: ${contextDescription}
-
+${subagentInstruction}
 Please generate:
 1. A concise and descriptive PR title (maximum 72 characters)
 2. A detailed PR description that includes:
@@ -943,10 +982,11 @@ ${fullDiff.substring(0, 50000)} ${fullDiff.length > 50000 ? '\n... (truncated di
   fs.writeFileSync(promptFile, prompt);
 
   info('Sending to Claude for analysis...');
-  
+  const startTime = Date.now();
+
   try {
     const response = execSync(`claude < "${promptFile}"`, { encoding: 'utf8', maxBuffer: 1024 * 1024 * 10 });
-    
+
     // Extraer el JSON de la respuesta
     const jsonMatch = response.match(/\{[\s\S]*\}/);
     if (!jsonMatch) {
@@ -954,7 +994,7 @@ ${fullDiff.substring(0, 50000)} ${fullDiff.length > 50000 ? '\n... (truncated di
       console.log('Complete response:', response);
       return;
     }
-    
+
     let result;
     try {
       result = JSON.parse(jsonMatch[0]);
@@ -963,44 +1003,44 @@ ${fullDiff.substring(0, 50000)} ${fullDiff.length > 50000 ? '\n... (truncated di
       console.log('JSON received:', jsonMatch[0]);
       return;
     }
-    
+
     // Show the results
     console.log('');
     console.log('════════════════════════════════════════════════════════════════');
     console.log('                      DIFFERENCES ANALYSIS                      ');
     console.log('════════════════════════════════════════════════════════════════');
     console.log('');
-    
+
     console.log(`🔍 ${colors.blue}Context:${colors.reset} ${contextDescription}`);
     console.log(`📊 ${colors.blue}Changed Files:${colors.reset} ${diffFiles.split('\n').length}`);
     console.log('');
-    
+
     console.log(`📝 ${colors.green}Pull Request Title:${colors.reset}`);
     console.log(`   ${result.prTitle}`);
     console.log('');
-    
+
     console.log(`🌿 ${colors.green}Suggested branch name:${colors.reset}`);
     console.log(`   ${result.suggestedBranchName}`);
     console.log('');
-    
+
     console.log(`📋 ${colors.green}Type of change:${colors.reset} ${result.changeType}`);
-    
+
     if (result.breakingChanges) {
       console.log(`⚠️  ${colors.yellow}Breaking Changes: SÍ${colors.reset}`);
     }
-    
+
     console.log('');
     console.log(`📄 ${colors.green}Pull Request Description:${colors.reset}`);
     console.log('───────────────────────────────────────────────────────────────');
     console.log(result.prDescription);
     console.log('───────────────────────────────────────────────────────────────');
-    
+
     if (result.testingNotes) {
       console.log('');
       console.log(`🧪 ${colors.green}Testing notes:${colors.reset}`);
       console.log(result.testingNotes);
     }
-    
+
     // Guardar los resultados en un archivo con contexto
     const outputData = {
       ...result,
@@ -1012,12 +1052,17 @@ ${fullDiff.substring(0, 50000)} ${fullDiff.length > 50000 ? '\n... (truncated di
         timestamp: new Date().toISOString()
       }
     };
-    
+
     const outputFile = '.claude-pr-analysis.json';
     fs.writeFileSync(outputFile, JSON.stringify(outputData, null, 2));
+
+    const elapsed = Date.now() - startTime;
+    const seconds = Math.floor(elapsed / 1000);
+    const ms = elapsed % 1000;
     console.log('');
+    console.log(`${colors.blue}⏱️  Analysis completed in ${seconds}.${ms}s${colors.reset}`);
     info(`Results saved in ${outputFile}`);
-    
+
     // Sugerencias contextuales
     console.log('');
     if (!args[0] && contextDescription.includes('local changes without push')) {
@@ -1030,9 +1075,9 @@ ${fullDiff.substring(0, 50000)} ${fullDiff.length > 50000 ? '\n... (truncated di
       console.log(`💡 ${colors.yellow}For renaming your current branch:${colors.reset}`);
       console.log(`   git branch -m ${result.suggestedBranchName}`);
     }
-    
+
     console.log(`💡 ${colors.yellow}Tip:${colors.reset} Use this information to create your PR on GitHub.`);
-    
+
   } catch (e) {
     error('Error executing Claude: ' + e.message);
   } finally {
@@ -1053,7 +1098,7 @@ function status() {
   hooks.forEach(hook => {
     const enabledPath = `.git/hooks/${hook}`;
     const disabledPath = `.git/hooks/${hook}.disabled`;
-    
+
     if (fs.existsSync(enabledPath)) {
       success(`${hook}: enabled`);
     } else if (fs.existsSync(disabledPath)) {
@@ -1084,7 +1129,7 @@ function status() {
     const gitignoreContent = fs.readFileSync(gitignorePath, 'utf8');
     const claudeIgnores = ['.claude/', 'debug-claude-response.json', '.claude-pr-analysis.json'];
     let allPresent = true;
-    
+
     claudeIgnores.forEach(entry => {
       const regex = new RegExp(`^${entry.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`, 'm');
       if (regex.test(gitignoreContent)) {
@@ -1094,7 +1139,7 @@ function status() {
         allPresent = false;
       }
     });
-    
+
     if (!allPresent) {
       info('\nRun "claude-hooks install" to update .gitignore');
     }
@@ -1116,12 +1161,12 @@ function compareVersions(v1, v2) {
     // Usar el script compartido para mantener consistencia
     const result = execSync(`bash -c 'source "${getTemplatesPath()}/check-version.sh" && compare_versions "${v1}" "${v2}"; echo $?'`, { encoding: 'utf8' }).trim();
     const exitCode = parseInt(result);
-    
+
     // Convertir los códigos de retorno del script bash a valores JS
     if (exitCode === 0) return 0;      // iguales
     if (exitCode === 1) return 1;      // v1 > v2  
     if (exitCode === 2) return -1;     // v1 < v2
-    
+
     // Fallback: comparación simple si el script falla
     if (v1 === v2) return 0;
     const sorted = [v1, v2].sort((a, b) => {
@@ -1145,13 +1190,13 @@ function compareVersions(v1, v2) {
 // Update command - update to the latest version
 async function update() {
   info('Checking latest available version...');
-  
+
   try {
     const currentVersion = require('../package.json').version;
     const latestVersion = await getLatestVersion('claude-git-hooks');
-    
+
     const comparison = compareVersions(currentVersion, latestVersion);
-    
+
     if (comparison === 0) {
       success(`You already have the latest version installed (${currentVersion})`);
       return;
@@ -1161,20 +1206,20 @@ async function update() {
       success(`You already have the latest version installed (${currentVersion})`);
       return;
     }
-    
+
     info(`Current version: ${currentVersion}`);
     info(`Available version: ${latestVersion}`);
-    
+
     // Actualizar el paquete
     info('Updating claude-git-hooks...');
     try {
       execSync('npm install -g claude-git-hooks@latest', { stdio: 'inherit' });
       success(`Successfully updated to version ${latestVersion}`);
-      
+
       // Reinstall hooks with the new version
       info('Reinstalling hooks with the new version...');
       await install(['--force']);
-      
+
     } catch (updateError) {
       error('Error updating. Try running: npm install -g claude-git-hooks@latest');
     }
@@ -1241,6 +1286,18 @@ Exclude code from analysis:
   ...excluded code...
   // SKIP_ANALYSIS_BLOCK
 
+Performance optimization (NEW in v1.5.5):
+  export CLAUDE_USE_SUBAGENTS=true        # Enable parallel analysis for 3+ files
+  export CLAUDE_SUBAGENT_MODEL=haiku      # Model: haiku (fast), sonnet, opus
+  export CLAUDE_SUBAGENT_BATCH_SIZE=3     # Parallel subagents per batch (default: 3)
+
+  # Batching examples:
+  # BATCH_SIZE=1 with 4 files → 4 sequential batches (1 subagent each)
+  # BATCH_SIZE=3 with 4 files → 2 batches (3 parallel, then 1)
+  # BATCH_SIZE=4 with 4 files → 1 batch (4 parallel subagents)
+
+  # Benefits: Faster for multi-file commits, shows execution time
+
 More information: https://github.com/pablorovito/claude-git-hooks
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-git-hooks",
-  "version": "1.5.4",
+  "version": "1.5.5",
   "description": "Git hooks con Claude CLI para análisis de código y generación automática de mensajes de commit",
   "main": "lib/index.js",
   "bin": {

package/templates/pre-commit

@@ -9,6 +9,14 @@ set -e
 CLAUDE_CLI="claude"
 TEMP_DIR="/tmp/code-review-$$"
 MAX_FILE_SIZE=100000  # 100KB maximum per file
+USE_SUBAGENTS="${CLAUDE_USE_SUBAGENTS:-false}"  # Use subagents for parallel analysis
+SUBAGENT_MODEL="${CLAUDE_SUBAGENT_MODEL:-haiku}"  # Model for subagents (haiku/sonnet/opus)
+SUBAGENT_BATCH_SIZE="${CLAUDE_SUBAGENT_BATCH_SIZE:-3}"  # Number of parallel subagents per batch
+
+# Validate batch size (must be >= 1)
+if [ "$SUBAGENT_BATCH_SIZE" -le 0 ] 2>/dev/null; then
+    SUBAGENT_BATCH_SIZE=1
+fi
 
 # Colors for output
 RED='\033[0;31m'
@@ -30,6 +38,16 @@ warning() {
     echo -e "${YELLOW}[WARNING]${NC} $1"
 }
 
+# Function to show elapsed time
+show_elapsed_time() {
+    local start_ms=$1
+    local end_ms=$(date +%s%3N 2>/dev/null || echo $(($(date +%s) * 1000)))
+    local elapsed=$((end_ms - start_ms))
+    local seconds=$((elapsed / 1000))
+    local ms=$((elapsed % 1000))
+    echo -e "${BLUE}⏱️  Analysis completed in ${seconds}.${ms}s${NC}"
+}
+
 # Check version at start (before any analysis)
 # Try to find the check-version.sh script
 CHECK_VERSION_SCRIPT=""
@@ -166,6 +184,15 @@ cleanup() {
     rm -rf "$TEMP_DIR"
 }
 
+# Function to inject subagent instruction for parallel analysis
+inject_subagent_instruction() {
+    if [ "$USE_SUBAGENTS" = "true" ]; then
+        echo ""
+        echo "IMPORTANT PARALLEL PROCESSING: If analyzing 3+ files, process them in batches of ${SUBAGENT_BATCH_SIZE}. For EACH batch, create that many subagents in parallel using Task tool (send single message with multiple Task calls). Each subagent analyzes one assigned file following OUTPUT_SCHEMA. After ALL batches complete, consolidate results into SINGLE JSON: (1) merge blockingIssues arrays, (2) merge details arrays, (3) sum issue counts, (4) worst-case metrics (lowest rating), (5) QUALITY_GATE=FAILED if ANY subagent found blockers/criticals, (6) approved=false if any disapproved. Model: ${SUBAGENT_MODEL}. Example: 4 files with BATCH_SIZE=1 → 4 sequential batches of 1 subagent each. Example: 4 files with BATCH_SIZE=3 → batch 1 has 3 parallel subagents (files 1-3), batch 2 has 1 subagent (file 4)."
+        echo ""
+    fi
+}
+
 # Configure cleanup on exit
 trap cleanup EXIT
 
@@ -250,6 +277,10 @@ cat "$PROMPT_TEMPLATE" > "$PROMPT_FILE"
 # Add the guidelines
 echo "=== EVALUATION GUIDELINES ===" >> "$PROMPT_FILE"
 cat "$GUIDELINES_FILE" >> "$PROMPT_FILE"
+
+# Inject subagent instruction if enabled
+inject_subagent_instruction >> "$PROMPT_FILE"
+
 echo -e "\n\n=== CHANGES TO REVIEW ===\n" >> "$PROMPT_FILE"
 
 # Process each Java file
@@ -300,6 +331,7 @@ log "Sending $FILE_COUNT files for review with Claude..."
 
 # Send to Claude and capture response
 RESPONSE_FILE="$TEMP_DIR/code_review_response.txt"
+START_TIME=$(date +%s%3N 2>/dev/null || echo $(($(date +%s) * 1000)))
 
 # Execute Claude CLI and capture the response
 if $CLAUDE_CLI < "$PROMPT_FILE" > "$RESPONSE_FILE" 2>&1; then
@@ -402,6 +434,7 @@ if $CLAUDE_CLI < "$PROMPT_FILE" > "$RESPONSE_FILE" 2>&1; then
     # Check if commit should be blocked
     if [ "$QUALITY_GATE" = "FAILED" ] || [ "$APPROVED" = "false" ]; then
         echo
+        show_elapsed_time "$START_TIME"
         error "❌ Commit blocked due to quality gate failure"
 
         # Show blocking issues if they exist
@@ -420,8 +453,9 @@ if $CLAUDE_CLI < "$PROMPT_FILE" > "$RESPONSE_FILE" 2>&1; then
     fi
 
     echo
+    show_elapsed_time "$START_TIME"
     log "✅ Code analysis completed. Quality gate passed."
-    
+
 else
     error "Error executing Claude CLI"
     error "Check that Claude CLI is configured correctly"

package/templates/prepare-commit-msg

@@ -10,11 +10,20 @@ CLAUDE_CLI="claude"
 TEMP_DIR="/tmp/commit-msg-$$"
 MAX_FILE_SIZE=100000
 AUTO_COMMIT_ENABLED=true
+USE_SUBAGENTS="${CLAUDE_USE_SUBAGENTS:-false}"  # Use subagents for parallel analysis
+SUBAGENT_MODEL="${CLAUDE_SUBAGENT_MODEL:-haiku}"  # Model for subagents (haiku/sonnet/opus)
+SUBAGENT_BATCH_SIZE="${CLAUDE_SUBAGENT_BATCH_SIZE:-3}"  # Number of parallel subagents per batch
+
+# Validate batch size (must be >= 1)
+if [ "$SUBAGENT_BATCH_SIZE" -le 0 ] 2>/dev/null; then
+    SUBAGENT_BATCH_SIZE=1
+fi
 
 # Colors for output
 RED='\033[0;31m'
 GREEN='\033[0;32m'
 YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
 NC='\033[0m'
 
 # Function for logging
@@ -26,10 +35,30 @@ warning() {
     printf "${YELLOW}[WARNING]${NC} %s\n" "$1" >&2
 }
 
+# Function to show elapsed time
+show_elapsed_time() {
+    local start_ms=$1
+    local end_ms=$(date +%s%3N 2>/dev/null || echo $(($(date +%s) * 1000)))
+    local elapsed=$((end_ms - start_ms))
+    local seconds=$((elapsed / 1000))
+    local ms=$((elapsed % 1000))
+    printf "${BLUE}⏱️  Message generation completed in ${seconds}.${ms}s${NC}\n" >&2
+}
+
 # Function to clean temporary files
 cleanup() {
     rm -rf "$TEMP_DIR"
 }
+
+# Function to inject subagent instruction for parallel analysis
+inject_subagent_instruction() {
+    if [ "$USE_SUBAGENTS" = "true" ]; then
+        echo ""
+        echo "IMPORTANT PARALLEL PROCESSING: If analyzing 3+ files, process them in batches of ${SUBAGENT_BATCH_SIZE}. For EACH batch, create that many subagents in parallel using Task tool (send single message with multiple Task calls). Each subagent analyzes one file and provides summary. After ALL batches complete, consolidate into SINGLE JSON with ONE commit message describing all changes. Determine type based on predominant change. Model: ${SUBAGENT_MODEL}. Example: 4 files with BATCH_SIZE=1 → 4 sequential batches of 1 subagent each. Example: 4 files with BATCH_SIZE=3 → batch 1 has 3 parallel subagents (files 1-3), batch 2 has 1 subagent (file 4)."
+        echo ""
+    fi
+}
+
 trap cleanup EXIT
 
 # Hook arguments
@@ -76,6 +105,9 @@ Respond ONLY with a valid JSON:
 CHANGES TO ANALYZE:
 EOF
 
+# Inject subagent instruction if enabled
+inject_subagent_instruction >> "$PROMPT_FILE"
+
 # Get staged files
 ALL_STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM 2>/dev/null || echo "")
 
@@ -105,6 +137,7 @@ done
 
 RESPONSE_FILE="$TEMP_DIR/commit_msg_response.txt"
 log "Generating commit message with Claude..."
+START_TIME=$(date +%s%3N 2>/dev/null || echo $(($(date +%s) * 1000)))
 
 if $CLAUDE_CLI < "$PROMPT_FILE" > "$RESPONSE_FILE" 2>&1; then
     JSON_MSG=$(sed -n '/^{/,/^}/p' "$RESPONSE_FILE" | head -n 1000)
@@ -127,6 +160,7 @@ if $CLAUDE_CLI < "$PROMPT_FILE" > "$RESPONSE_FILE" 2>&1; then
             fi
             
             printf "%s\n" "$FULL_MESSAGE" > "$COMMIT_MSG_FILE"
+            show_elapsed_time "$START_TIME"
             log "📝 Message generated: $(echo "$FULL_MESSAGE" | head -n 1)"
             exit 0
         fi