agentic-team-templates 0.4.2 → 0.6.0

package/src/index.js

@@ -50,6 +50,10 @@ const SHARED_RULES = [
   'security-fundamentals.md'
 ];
 
+// Supported IDEs/tools
+const SUPPORTED_IDES = ['cursor', 'claude', 'codex'];
+const DEFAULT_IDES = ['cursor', 'claude', 'codex']; // Default: install for all IDEs
+
 // Colors
 const colors = {
   red: (s) => `\x1b[31m${s}\x1b[0m`,
@@ -69,21 +73,44 @@ function printBanner() {
 
 function printHelp() {
   console.log(`${colors.yellow('Usage:')}
-  npx cursor-templates <templates...>
+  npx cursor-templates <templates...> [options]
+  npx cursor-templates --remove <templates...> [options]
+  npx cursor-templates --reset [options]
 
 ${colors.yellow('Options:')}
+  --ide=<name>   Install for specific IDE (cursor, claude, codex)
+                 Can be specified multiple times: --ide=cursor --ide=claude
+                 Default: all (cursor, claude, codex)
   --list, -l     List available templates
   --help, -h     Show this help message
-  --dry-run      Show what would be installed
-  --force, -f    Overwrite existing files (default: skip)
+  --dry-run      Show what would be changed
+  --force, -f    Overwrite/remove even if files were modified
+  --yes, -y      Skip confirmation prompt (for --remove and --reset)
+
+${colors.yellow('Removal Options:')}
+  --remove       Remove specified templates (keeps shared rules and other templates)
+  --reset        Remove ALL installed content (shared rules, templates, generated files)
+
+${colors.yellow('IDE Targets:')}
+  cursor         .cursorrules/ directory (Cursor IDE)
+  claude         CLAUDE.md file (Claude Code, Cursor with Claude)
+  codex          .github/copilot-instructions.md (GitHub Copilot)
 
 ${colors.yellow('Examples:')}
   npx cursor-templates web-frontend
-  npx cursor-templates web-frontend web-backend
-  npx cursor-templates fullstack
-  npx cursor-templates mobile utility-agent
+  npx cursor-templates web-frontend --ide=cursor
+  npx cursor-templates web-frontend --ide=claude --ide=codex
+  npx cursor-templates fullstack --ide=codex
   npx cursor-templates web-backend --force
 
+${colors.yellow('Removal Examples:')}
+  npx cursor-templates --remove web-frontend
+  npx cursor-templates --remove web-frontend web-backend
+  npx cursor-templates --remove web-frontend --ide=cursor
+  npx cursor-templates --reset
+  npx cursor-templates --reset --ide=cursor
+  npx cursor-templates --reset --yes
+
 ${colors.dim('Shared rules (code-quality, security, git-workflow, etc.) are always included.')}
 ${colors.dim('Identical files are skipped. Modified files are preserved; ours saved as *-1.md.')}
 ${colors.dim('CLAUDE.md: missing sections are intelligently merged (not overwritten).')}
@@ -469,146 +496,291 @@ function generateClaudeMdToPath(targetDir, installedTemplates, destPath) {
   fs.writeFileSync(destPath, content);
 }
 
-function install(targetDir, templates, dryRun = false, force = false) {
-  const cursorrules = path.join(targetDir, '.cursorrules');
-  
-  if (!dryRun && !fs.existsSync(cursorrules)) {
-    fs.mkdirSync(cursorrules, { recursive: true });
-  }
+/**
+ * Generate content for GitHub Copilot instructions file
+ */
+function generateCopilotInstructionsContent(installedTemplates) {
+  const templateList = installedTemplates
+    .map(t => `- ${t}: ${TEMPLATES[t].description}`)
+    .join('\n');
+
+  // Read and concatenate all shared rules
+  const sharedRulesContent = SHARED_RULES.map(rule => {
+    const rulePath = path.join(TEMPLATES_DIR, '_shared', rule);
+    try {
+      return fs.readFileSync(rulePath, 'utf8');
+    } catch {
+      return '';
+    }
+  }).filter(Boolean).join('\n\n---\n\n');
+
+  // Read and concatenate template-specific rules
+  const templateRulesContent = installedTemplates.map(template => {
+    return TEMPLATES[template].rules.map(rule => {
+      const rulePath = path.join(TEMPLATES_DIR, template, '.cursorrules', rule);
+      try {
+        return fs.readFileSync(rulePath, 'utf8');
+      } catch {
+        return '';
+      }
+    }).filter(Boolean).join('\n\n');
+  }).join('\n\n---\n\n');
+
+  return `# Copilot Instructions
+
+This file provides coding guidelines for GitHub Copilot in this project.
+
+## Project Configuration
+
+**Installed Templates:** ${installedTemplates.join(', ')}
+
+${templateList}
+
+---
+
+## Core Principles
+
+### Honesty Over Output
+- If something doesn't work, say it doesn't work
+- If you don't know, say you don't know
+- Never hide errors or suppress warnings
+
+### Security First
+- Zero trust: Every input is hostile until proven otherwise
+- Validate and sanitize all inputs
+- No secrets in code or logs
+
+### Tests Are Required
+- No feature is complete without tests
+- Test behavior, not implementation
+
+### Code Quality
+- SOLID principles
+- DRY (Don't Repeat Yourself)
+- Explicit over implicit
+
+---
+
+## Shared Guidelines
+
+${sharedRulesContent}
+
+---
+
+## Template-Specific Guidelines
+
+${templateRulesContent}
+
+---
+
+## Definition of Done
+
+A feature is complete when:
+- [ ] Code written and reviewed
+- [ ] Tests written and passing
+- [ ] No linting errors
+- [ ] Security reviewed
+- [ ] Documentation updated
+`;
+}
+
+function install(targetDir, templates, dryRun = false, force = false, ides = DEFAULT_IDES) {
+  const stats = { copied: 0, skipped: 0, updated: 0, renamed: 0 };
+  const renamedFiles = [];
+  const installedFor = [];
 
   console.log(`${colors.blue('Installing to:')} ${targetDir}`);
+  console.log(`${colors.blue('Target IDEs:')} ${ides.join(', ')}`);
   if (!force) {
     console.log(colors.dim('(identical files skipped, modified files preserved with ours saved as *-1.md)'));
-    console.log(colors.dim('(CLAUDE.md: missing sections merged intelligently)'));
   }
   console.log();
 
-  const stats = { copied: 0, skipped: 0, updated: 0, renamed: 0 };
-  const renamedFiles = [];
-
-  // 1. Install shared rules
-  console.log(colors.green('► Installing shared rules...'));
-  for (const rule of SHARED_RULES) {
-    const src = path.join(TEMPLATES_DIR, '_shared', rule);
-    const dest = path.join(cursorrules, rule);
+  // 1. Install .cursorrules/ for Cursor IDE
+  if (ides.includes('cursor')) {
+    installedFor.push('cursor');
+    const cursorrules = path.join(targetDir, '.cursorrules');
     
-    if (dryRun) {
-      const exists = fs.existsSync(dest);
-      if (!exists) {
-        console.log(`  ${colors.dim('[copy]')} ${rule}`);
-      } else if (force) {
-        console.log(`  ${colors.dim('[update]')} ${rule}`);
-      } else if (filesMatch(src, dest)) {
-        console.log(`  ${colors.yellow('[skip]')} ${rule} (identical)`);
-      } else {
-        const altName = path.basename(getAlternateFilename(dest));
-        console.log(`  ${colors.blue('[rename]')} ${rule} → ${altName}`);
-      }
-    } else {
-      const result = copyFile(src, dest, force);
-      stats[result.status]++;
-      if (result.status === 'skipped') {
-        console.log(`  ${colors.yellow('[skip]')} ${rule} (identical)`);
-      } else if (result.status === 'renamed') {
-        const altName = path.basename(result.destFile);
-        renamedFiles.push({ original: rule, renamed: altName });
-        console.log(`  ${colors.blue('[rename]')} ${rule} → ${altName}`);
-      } else {
-        console.log(`  ${colors.dim(`[${result.status}]`)} ${rule}`);
-      }
+    if (!dryRun && !fs.existsSync(cursorrules)) {
+      fs.mkdirSync(cursorrules, { recursive: true });
     }
-  }
-  console.log();
 
-  // 2. Install template-specific rules
-  for (const template of templates) {
-    console.log(colors.green(`► Installing ${template} template...`));
-    
-    for (const rule of TEMPLATES[template].rules) {
-      const src = path.join(TEMPLATES_DIR, template, '.cursorrules', rule);
-      const dest = path.join(cursorrules, `${template}-${rule}`);
-      const destName = `${template}-${rule}`;
+    // Install shared rules
+    console.log(colors.green('► Installing shared rules (.cursorrules/)...'));
+    for (const rule of SHARED_RULES) {
+      const src = path.join(TEMPLATES_DIR, '_shared', rule);
+      const dest = path.join(cursorrules, rule);
       
       if (dryRun) {
         const exists = fs.existsSync(dest);
         if (!exists) {
-          console.log(`  ${colors.dim('[copy]')} ${destName}`);
+          console.log(`  ${colors.dim('[copy]')} ${rule}`);
         } else if (force) {
-          console.log(`  ${colors.dim('[update]')} ${destName}`);
+          console.log(`  ${colors.dim('[update]')} ${rule}`);
         } else if (filesMatch(src, dest)) {
-          console.log(`  ${colors.yellow('[skip]')} ${destName} (identical)`);
+          console.log(`  ${colors.yellow('[skip]')} ${rule} (identical)`);
         } else {
           const altName = path.basename(getAlternateFilename(dest));
-          console.log(`  ${colors.blue('[rename]')} ${destName} → ${altName}`);
+          console.log(`  ${colors.blue('[rename]')} ${rule} → ${altName}`);
         }
       } else {
         const result = copyFile(src, dest, force);
         stats[result.status]++;
         if (result.status === 'skipped') {
-          console.log(`  ${colors.yellow('[skip]')} ${destName} (identical)`);
+          console.log(`  ${colors.yellow('[skip]')} ${rule} (identical)`);
         } else if (result.status === 'renamed') {
           const altName = path.basename(result.destFile);
-          renamedFiles.push({ original: destName, renamed: altName });
-          console.log(`  ${colors.blue('[rename]')} ${destName} → ${altName}`);
+          renamedFiles.push({ original: rule, renamed: altName });
+          console.log(`  ${colors.blue('[rename]')} ${rule} → ${altName}`);
         } else {
-          console.log(`  ${colors.dim(`[${result.status}]`)} ${destName}`);
+          console.log(`  ${colors.dim(`[${result.status}]`)} ${rule}`);
         }
       }
     }
     console.log();
+
+    // Install template-specific rules
+    for (const template of templates) {
+      console.log(colors.green(`► Installing ${template} template (.cursorrules/)...`));
+      
+      for (const rule of TEMPLATES[template].rules) {
+        const src = path.join(TEMPLATES_DIR, template, '.cursorrules', rule);
+        const dest = path.join(cursorrules, `${template}-${rule}`);
+        const destName = `${template}-${rule}`;
+        
+        if (dryRun) {
+          const exists = fs.existsSync(dest);
+          if (!exists) {
+            console.log(`  ${colors.dim('[copy]')} ${destName}`);
+          } else if (force) {
+            console.log(`  ${colors.dim('[update]')} ${destName}`);
+          } else if (filesMatch(src, dest)) {
+            console.log(`  ${colors.yellow('[skip]')} ${destName} (identical)`);
+          } else {
+            const altName = path.basename(getAlternateFilename(dest));
+            console.log(`  ${colors.blue('[rename]')} ${destName} → ${altName}`);
+          }
+        } else {
+          const result = copyFile(src, dest, force);
+          stats[result.status]++;
+          if (result.status === 'skipped') {
+            console.log(`  ${colors.yellow('[skip]')} ${destName} (identical)`);
+          } else if (result.status === 'renamed') {
+            const altName = path.basename(result.destFile);
+            renamedFiles.push({ original: destName, renamed: altName });
+            console.log(`  ${colors.blue('[rename]')} ${destName} → ${altName}`);
+          } else {
+            console.log(`  ${colors.dim(`[${result.status}]`)} ${destName}`);
+          }
+        }
+      }
+      console.log();
+    }
   }
 
-  // 3. Generate CLAUDE.md
-  const claudePath = path.join(targetDir, 'CLAUDE.md');
-  const claudeExists = fs.existsSync(claudePath);
-  const templateContent = generateClaudeMdContent(templates);
-  
-  console.log(colors.green('► Generating CLAUDE.md...'));
-  if (dryRun) {
-    if (!claudeExists) {
-      console.log(`  ${colors.dim('[copy]')} CLAUDE.md`);
+  // 2. Generate CLAUDE.md for Claude Code
+  if (ides.includes('claude')) {
+    installedFor.push('claude');
+    const claudePath = path.join(targetDir, 'CLAUDE.md');
+    const claudeExists = fs.existsSync(claudePath);
+    const templateContent = generateClaudeMdContent(templates);
+    
+    console.log(colors.green('► Generating CLAUDE.md (Claude Code)...'));
+    if (dryRun) {
+      if (!claudeExists) {
+        console.log(`  ${colors.dim('[copy]')} CLAUDE.md`);
+      } else if (force) {
+        console.log(`  ${colors.dim('[update]')} CLAUDE.md`);
+      } else {
+        const existingContent = fs.readFileSync(claudePath, 'utf8');
+        const { missing } = findMissingSections(existingContent, templateContent);
+        if (missing.length === 0) {
+          console.log(`  ${colors.yellow('[skip]')} CLAUDE.md (all sections present)`);
+        } else {
+          console.log(`  ${colors.blue('[merge]')} CLAUDE.md (would add ${missing.length} section(s))`);
+          for (const section of missing) {
+            console.log(`    ${colors.dim('+')} ${section.heading}`);
+          }
+        }
+      }
+    } else if (!claudeExists) {
+      fs.writeFileSync(claudePath, templateContent);
+      console.log(`  ${colors.dim('[copied]')} CLAUDE.md`);
+      stats.copied++;
     } else if (force) {
-      console.log(`  ${colors.dim('[update]')} CLAUDE.md`);
+      fs.writeFileSync(claudePath, templateContent);
+      console.log(`  ${colors.dim('[updated]')} CLAUDE.md`);
+      stats.updated++;
     } else {
-      // Check what would be merged
       const existingContent = fs.readFileSync(claudePath, 'utf8');
-      const { missing } = findMissingSections(existingContent, templateContent);
-      if (missing.length === 0) {
+      const { merged, addedSections } = mergeClaudeContent(existingContent, templateContent);
+      
+      if (addedSections.length === 0) {
         console.log(`  ${colors.yellow('[skip]')} CLAUDE.md (all sections present)`);
+        stats.skipped++;
       } else {
-        console.log(`  ${colors.blue('[merge]')} CLAUDE.md (would add ${missing.length} section(s))`);
-        for (const section of missing) {
-          console.log(`    ${colors.dim('+')} ${section.heading}`);
+        fs.writeFileSync(claudePath, merged);
+        console.log(`  ${colors.blue('[merged]')} CLAUDE.md`);
+        console.log(`    ${colors.green('Added sections:')}`);
+        for (const heading of addedSections) {
+          console.log(`      ${colors.dim('+')} ${heading}`);
         }
+        stats.updated++;
       }
     }
-  } else if (!claudeExists) {
-    fs.writeFileSync(claudePath, templateContent);
-    console.log(`  ${colors.dim('[copied]')} CLAUDE.md`);
-    stats.copied++;
-  } else if (force) {
-    fs.writeFileSync(claudePath, templateContent);
-    console.log(`  ${colors.dim('[updated]')} CLAUDE.md`);
-    stats.updated++;
-  } else {
-    // Intelligent merge: append only missing sections
-    const existingContent = fs.readFileSync(claudePath, 'utf8');
-    const { merged, addedSections } = mergeClaudeContent(existingContent, templateContent);
+    console.log();
+  }
+
+  // 3. Generate .github/copilot-instructions.md for GitHub Copilot (Codex)
+  if (ides.includes('codex')) {
+    installedFor.push('codex');
+    const githubDir = path.join(targetDir, '.github');
+    const copilotPath = path.join(githubDir, 'copilot-instructions.md');
+    const copilotExists = fs.existsSync(copilotPath);
+    const copilotContent = generateCopilotInstructionsContent(templates);
     
-    if (addedSections.length === 0) {
-      console.log(`  ${colors.yellow('[skip]')} CLAUDE.md (all sections present)`);
-      stats.skipped++;
-    } else {
-      fs.writeFileSync(claudePath, merged);
-      console.log(`  ${colors.blue('[merged]')} CLAUDE.md`);
-      console.log(`    ${colors.green('Added sections:')}`);
-      for (const heading of addedSections) {
-        console.log(`      ${colors.dim('+')} ${heading}`);
+    if (!dryRun && !fs.existsSync(githubDir)) {
+      fs.mkdirSync(githubDir, { recursive: true });
+    }
+    
+    console.log(colors.green('► Generating .github/copilot-instructions.md (GitHub Copilot)...'));
+    if (dryRun) {
+      if (!copilotExists) {
+        console.log(`  ${colors.dim('[copy]')} .github/copilot-instructions.md`);
+      } else if (force) {
+        console.log(`  ${colors.dim('[update]')} .github/copilot-instructions.md`);
+      } else {
+        const existingContent = fs.readFileSync(copilotPath, 'utf8');
+        const { missing } = findMissingSections(existingContent, copilotContent);
+        if (missing.length === 0) {
+          console.log(`  ${colors.yellow('[skip]')} .github/copilot-instructions.md (all sections present)`);
+        } else {
+          console.log(`  ${colors.blue('[merge]')} .github/copilot-instructions.md (would add ${missing.length} section(s))`);
+        }
       }
+    } else if (!copilotExists) {
+      fs.writeFileSync(copilotPath, copilotContent);
+      console.log(`  ${colors.dim('[copied]')} .github/copilot-instructions.md`);
+      stats.copied++;
+    } else if (force) {
+      fs.writeFileSync(copilotPath, copilotContent);
+      console.log(`  ${colors.dim('[updated]')} .github/copilot-instructions.md`);
       stats.updated++;
+    } else {
+      const existingContent = fs.readFileSync(copilotPath, 'utf8');
+      const { merged, addedSections } = mergeClaudeContent(existingContent, copilotContent);
+      
+      if (addedSections.length === 0) {
+        console.log(`  ${colors.yellow('[skip]')} .github/copilot-instructions.md (all sections present)`);
+        stats.skipped++;
+      } else {
+        fs.writeFileSync(copilotPath, merged);
+        console.log(`  ${colors.blue('[merged]')} .github/copilot-instructions.md`);
+        stats.updated++;
+      }
     }
+    console.log();
   }
-  console.log();
 
   // Summary
   console.log(colors.green('════════════════════════════════════════════════════════════'));
@@ -627,7 +799,18 @@ function install(targetDir, templates, dryRun = false, force = false) {
   }
   console.log();
   
-  console.log(colors.yellow('Templates installed:'));
+  console.log(colors.yellow('Installed for:'));
+  for (const ide of installedFor) {
+    const ideInfo = {
+      cursor: '.cursorrules/ (Cursor IDE)',
+      claude: 'CLAUDE.md (Claude Code)',
+      codex: '.github/copilot-instructions.md (GitHub Copilot)'
+    };
+    console.log(`  - ${ideInfo[ide]}`);
+  }
+  console.log();
+  
+  console.log(colors.yellow('Templates:'));
   console.log('  - _shared (always included)');
   for (const template of templates) {
     console.log(`  - ${template}`);
@@ -645,51 +828,489 @@ function install(targetDir, templates, dryRun = false, force = false) {
   }
   
   console.log(colors.blue('Next steps:'));
-  console.log('  1. Review CLAUDE.md for any customization');
-  console.log('  2. Commit the new files to your repository');
+  if (installedFor.includes('claude')) {
+    console.log('  1. Review CLAUDE.md for any customization');
+  }
+  if (installedFor.includes('codex')) {
+    console.log('  2. Review .github/copilot-instructions.md');
+  }
+  console.log('  3. Commit the new files to your repository');
+  console.log();
+}
+
+/**
+ * Prompt user for confirmation
+ * @param {string} message - The prompt message
+ * @returns {Promise<boolean>}
+ */
+async function confirm(message) {
+  const readline = await import('readline');
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  return new Promise((resolve) => {
+    rl.question(`${message} [y/N] `, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+    });
+  });
+}
+
+/**
+ * Check if a file was created by our installer (matches template content)
+ * @param {string} filePath - Path to the file
+ * @param {string} templatePath - Path to the template file
+ * @returns {boolean}
+ */
+function isOurFile(filePath, templatePath) {
+  if (!fs.existsSync(filePath)) return false;
+  if (!fs.existsSync(templatePath)) return true; // No template to compare, assume ours
+  return filesMatch(filePath, templatePath);
+}
+
+/**
+ * Remove specific templates from the installation
+ */
+async function remove(targetDir, templates, dryRun = false, force = false, skipConfirm = false, ides = DEFAULT_IDES) {
+  const stats = { removed: 0, skipped: 0, notFound: 0 };
+  const filesToRemove = [];
+  const modifiedFiles = [];
+
+  console.log(`${colors.blue('Removing from:')} ${targetDir}`);
+  console.log(`${colors.blue('Target IDEs:')} ${ides.join(', ')}`);
+  console.log(`${colors.blue('Templates:')} ${templates.join(', ')}`);
+  console.log();
+
+  // 1. Collect files to remove from .cursorrules/
+  if (ides.includes('cursor')) {
+    const cursorrules = path.join(targetDir, '.cursorrules');
+    
+    if (fs.existsSync(cursorrules)) {
+      for (const template of templates) {
+        console.log(colors.yellow(`► Scanning ${template} template files...`));
+        
+        for (const rule of TEMPLATES[template].rules) {
+          const destName = `${template}-${rule}`;
+          const destPath = path.join(cursorrules, destName);
+          const srcPath = path.join(TEMPLATES_DIR, template, '.cursorrules', rule);
+          
+          if (!fs.existsSync(destPath)) {
+            console.log(`  ${colors.dim('[not found]')} ${destName}`);
+            stats.notFound++;
+            continue;
+          }
+          
+          const isUnmodified = isOurFile(destPath, srcPath);
+          
+          if (!isUnmodified && !force) {
+            console.log(`  ${colors.yellow('[modified]')} ${destName} (use --force to remove)`);
+            modifiedFiles.push(destName);
+            stats.skipped++;
+          } else {
+            console.log(`  ${colors.red('[remove]')} ${destName}${!isUnmodified ? ' (modified, --force)' : ''}`);
+            filesToRemove.push({ path: destPath, name: destName });
+          }
+        }
+        
+        // Also check for -1 variant files
+        for (const rule of TEMPLATES[template].rules) {
+          const altName = `${template}-${rule.replace('.md', '-1.md')}`;
+          const altPath = path.join(cursorrules, altName);
+          
+          if (fs.existsSync(altPath)) {
+            console.log(`  ${colors.red('[remove]')} ${altName} (alternate file)`);
+            filesToRemove.push({ path: altPath, name: altName });
+          }
+        }
+        
+        console.log();
+      }
+    } else {
+      console.log(colors.dim('No .cursorrules/ directory found.\n'));
+    }
+  }
+
+  // 2. Note about CLAUDE.md and copilot-instructions.md
+  // These are regenerated, not patched, so we can't easily remove just one template's content
+  // We'll warn the user about this
+  if (ides.includes('claude') || ides.includes('codex')) {
+    console.log(colors.yellow('Note: CLAUDE.md and copilot-instructions.md contain merged content.'));
+    console.log(colors.dim('To update these files, re-run the installer with the remaining templates.\n'));
+  }
+
+  if (filesToRemove.length === 0) {
+    console.log(colors.yellow('Nothing to remove.\n'));
+    return;
+  }
+
+  // Confirmation
+  if (!dryRun && !skipConfirm) {
+    console.log(colors.yellow(`\nAbout to remove ${filesToRemove.length} file(s).`));
+    const confirmed = await confirm(colors.red('Proceed with removal?'));
+    if (!confirmed) {
+      console.log(colors.dim('\nAborted.\n'));
+      return;
+    }
+    console.log();
+  }
+
+  // Execute removal
+  if (dryRun) {
+    console.log(colors.yellow('DRY RUN - No files were removed.\n'));
+  } else {
+    for (const file of filesToRemove) {
+      try {
+        fs.unlinkSync(file.path);
+        stats.removed++;
+      } catch (err) {
+        console.error(colors.red(`Failed to remove ${file.name}: ${err.message}`));
+      }
+    }
+  }
+
+  // Summary
+  console.log(colors.green('════════════════════════════════════════════════════════════'));
+  console.log(colors.green(`✓ Removal complete!\n`));
+  
+  console.log(colors.yellow('Summary:'));
+  console.log(`  - ${stats.removed} files removed`);
+  if (stats.skipped > 0) {
+    console.log(`  - ${stats.skipped} files skipped (modified, use --force)`);
+  }
+  if (stats.notFound > 0) {
+    console.log(`  - ${stats.notFound} files not found`);
+  }
+  console.log();
+
+  if (modifiedFiles.length > 0) {
+    console.log(colors.yellow('Modified files preserved:'));
+    for (const file of modifiedFiles) {
+      console.log(`  - ${file}`);
+    }
+    console.log(colors.dim('\nUse --force to remove modified files.\n'));
+  }
+}
+
+/**
+ * Reset - remove all installed content
+ */
+async function reset(targetDir, dryRun = false, force = false, skipConfirm = false, ides = DEFAULT_IDES) {
+  const stats = { removed: 0, skipped: 0 };
+  const filesToRemove = [];
+  const modifiedFiles = [];
+  const dirsToRemove = [];
+
+  console.log(`${colors.blue('Resetting:')} ${targetDir}`);
+  console.log(`${colors.blue('Target IDEs:')} ${ides.join(', ')}`);
+  console.log();
+
+  // 1. Remove .cursorrules/ contents for Cursor
+  if (ides.includes('cursor')) {
+    const cursorrules = path.join(targetDir, '.cursorrules');
+    
+    if (fs.existsSync(cursorrules)) {
+      console.log(colors.yellow('► Scanning .cursorrules/ directory...'));
+      
+      // Check shared rules
+      for (const rule of SHARED_RULES) {
+        const destPath = path.join(cursorrules, rule);
+        const srcPath = path.join(TEMPLATES_DIR, '_shared', rule);
+        
+        if (!fs.existsSync(destPath)) continue;
+        
+        const isUnmodified = isOurFile(destPath, srcPath);
+        
+        if (!isUnmodified && !force) {
+          console.log(`  ${colors.yellow('[modified]')} ${rule} (use --force to remove)`);
+          modifiedFiles.push(rule);
+          stats.skipped++;
+        } else {
+          console.log(`  ${colors.red('[remove]')} ${rule}${!isUnmodified ? ' (modified, --force)' : ''}`);
+          filesToRemove.push({ path: destPath, name: rule });
+        }
+        
+        // Check for -1 variant
+        const altPath = path.join(cursorrules, rule.replace('.md', '-1.md'));
+        if (fs.existsSync(altPath)) {
+          console.log(`  ${colors.red('[remove]')} ${rule.replace('.md', '-1.md')} (alternate file)`);
+          filesToRemove.push({ path: altPath, name: rule.replace('.md', '-1.md') });
+        }
+      }
+      
+      // Check template-specific rules
+      for (const [templateName, templateInfo] of Object.entries(TEMPLATES)) {
+        for (const rule of templateInfo.rules) {
+          const destName = `${templateName}-${rule}`;
+          const destPath = path.join(cursorrules, destName);
+          const srcPath = path.join(TEMPLATES_DIR, templateName, '.cursorrules', rule);
+          
+          if (!fs.existsSync(destPath)) continue;
+          
+          const isUnmodified = isOurFile(destPath, srcPath);
+          
+          if (!isUnmodified && !force) {
+            console.log(`  ${colors.yellow('[modified]')} ${destName} (use --force to remove)`);
+            modifiedFiles.push(destName);
+            stats.skipped++;
+          } else {
+            console.log(`  ${colors.red('[remove]')} ${destName}${!isUnmodified ? ' (modified, --force)' : ''}`);
+            filesToRemove.push({ path: destPath, name: destName });
+          }
+          
+          // Check for -1 variant
+          const altName = destName.replace('.md', '-1.md');
+          const altPath = path.join(cursorrules, altName);
+          if (fs.existsSync(altPath)) {
+            console.log(`  ${colors.red('[remove]')} ${altName} (alternate file)`);
+            filesToRemove.push({ path: altPath, name: altName });
+          }
+        }
+      }
+      
+      // Check if we should remove the directory itself (only if it would be empty)
+      const remainingFiles = fs.readdirSync(cursorrules).filter(f => {
+        const fullPath = path.join(cursorrules, f);
+        const willBeRemoved = filesToRemove.some(fr => fr.path === fullPath);
+        return !willBeRemoved;
+      });
+      
+      if (remainingFiles.length === 0 || force) {
+        console.log(`  ${colors.red('[remove]')} .cursorrules/ directory`);
+        dirsToRemove.push(cursorrules);
+      } else if (remainingFiles.length > 0) {
+        console.log(colors.dim(`  .cursorrules/ will be kept (${remainingFiles.length} non-template file(s) remain)`));
+      }
+      
+      console.log();
+    } else {
+      console.log(colors.dim('No .cursorrules/ directory found.\n'));
+    }
+  }
+
+  // 2. Remove CLAUDE.md for Claude
+  if (ides.includes('claude')) {
+    const claudePath = path.join(targetDir, 'CLAUDE.md');
+    
+    if (fs.existsSync(claudePath)) {
+      console.log(colors.yellow('► Checking CLAUDE.md...'));
+      
+      // Check if it contains our signature content
+      const content = fs.readFileSync(claudePath, 'utf8');
+      const isOurs = content.includes('# CLAUDE.md - Development Guide') && 
+                     content.includes('.cursorrules/');
+      
+      if (!isOurs && !force) {
+        console.log(`  ${colors.yellow('[modified]')} CLAUDE.md (doesn't match template, use --force)`);
+        modifiedFiles.push('CLAUDE.md');
+        stats.skipped++;
+      } else {
+        console.log(`  ${colors.red('[remove]')} CLAUDE.md${!isOurs ? ' (modified, --force)' : ''}`);
+        filesToRemove.push({ path: claudePath, name: 'CLAUDE.md' });
+      }
+      console.log();
+    }
+  }
+
+  // 3. Remove .github/copilot-instructions.md for Codex
+  if (ides.includes('codex')) {
+    const copilotPath = path.join(targetDir, '.github', 'copilot-instructions.md');
+    
+    if (fs.existsSync(copilotPath)) {
+      console.log(colors.yellow('► Checking .github/copilot-instructions.md...'));
+      
+      // Check if it contains our signature content
+      const content = fs.readFileSync(copilotPath, 'utf8');
+      const isOurs = content.includes('# Copilot Instructions') && 
+                     content.includes('Installed Templates:');
+      
+      if (!isOurs && !force) {
+        console.log(`  ${colors.yellow('[modified]')} .github/copilot-instructions.md (doesn't match template, use --force)`);
+        modifiedFiles.push('.github/copilot-instructions.md');
+        stats.skipped++;
+      } else {
+        console.log(`  ${colors.red('[remove]')} .github/copilot-instructions.md${!isOurs ? ' (modified, --force)' : ''}`);
+        filesToRemove.push({ path: copilotPath, name: '.github/copilot-instructions.md' });
+      }
+      console.log();
+    }
+  }
+
+  if (filesToRemove.length === 0 && dirsToRemove.length === 0) {
+    console.log(colors.yellow('Nothing to remove.\n'));
+    return;
+  }
+
+  // Confirmation
+  if (!dryRun && !skipConfirm) {
+    const totalItems = filesToRemove.length + dirsToRemove.length;
+    console.log(colors.yellow(`\nAbout to remove ${totalItems} item(s).`));
+    const confirmed = await confirm(colors.red('Proceed with reset?'));
+    if (!confirmed) {
+      console.log(colors.dim('\nAborted.\n'));
+      return;
+    }
+    console.log();
+  }
+
+  // Execute removal
+  if (dryRun) {
+    console.log(colors.yellow('DRY RUN - No files were removed.\n'));
+  } else {
+    // Remove files first
+    for (const file of filesToRemove) {
+      try {
+        fs.unlinkSync(file.path);
+        stats.removed++;
+      } catch (err) {
+        console.error(colors.red(`Failed to remove ${file.name}: ${err.message}`));
+      }
+    }
+    
+    // Then remove directories
+    for (const dir of dirsToRemove) {
+      try {
+        // Check if directory is now empty
+        const remaining = fs.existsSync(dir) ? fs.readdirSync(dir) : [];
+        if (remaining.length === 0) {
+          fs.rmdirSync(dir);
+          stats.removed++;
+        } else if (force) {
+          fs.rmSync(dir, { recursive: true });
+          stats.removed++;
+        }
+      } catch (err) {
+        console.error(colors.red(`Failed to remove directory: ${err.message}`));
+      }
+    }
+  }
+
+  // Summary
+  console.log(colors.green('════════════════════════════════════════════════════════════'));
+  console.log(colors.green(`✓ Reset complete!\n`));
+  
+  console.log(colors.yellow('Summary:'));
+  console.log(`  - ${stats.removed} items removed`);
+  if (stats.skipped > 0) {
+    console.log(`  - ${stats.skipped} files skipped (modified, use --force)`);
+  }
   console.log();
+
+  if (modifiedFiles.length > 0) {
+    console.log(colors.yellow('Modified files preserved:'));
+    for (const file of modifiedFiles) {
+      console.log(`  - ${file}`);
+    }
+    console.log(colors.dim('\nUse --force to remove modified files.\n'));
+  }
 }
 
-export function run(args) {
+export async function run(args) {
   const templates = [];
+  const ides = [];
   let dryRun = false;
   let force = false;
+  let skipConfirm = false;
+  let removeMode = false;
+  let resetMode = false;
 
   // Parse arguments
   for (const arg of args) {
-    switch (arg) {
-      case '--list':
-      case '-l':
-        printBanner();
-        printTemplates();
-        process.exit(0);
-        break;
-      case '--help':
-      case '-h':
-        printBanner();
-        printHelp();
-        process.exit(0);
-        break;
-      case '--dry-run':
-        dryRun = true;
-        break;
-      case '--force':
-      case '-f':
-        force = true;
-        break;
-      default:
-        if (arg.startsWith('-')) {
-          console.error(colors.red(`Error: Unknown option '${arg}'`));
-          printHelp();
-          process.exit(1);
-        }
-        templates.push(arg);
+    if (arg === '--list' || arg === '-l') {
+      printBanner();
+      printTemplates();
+      process.exit(0);
+    } else if (arg === '--help' || arg === '-h') {
+      printBanner();
+      printHelp();
+      process.exit(0);
+    } else if (arg === '--dry-run') {
+      dryRun = true;
+    } else if (arg === '--force' || arg === '-f') {
+      force = true;
+    } else if (arg === '--yes' || arg === '-y') {
+      skipConfirm = true;
+    } else if (arg === '--remove') {
+      removeMode = true;
+    } else if (arg === '--reset') {
+      resetMode = true;
+    } else if (arg.startsWith('--ide=')) {
+      const ide = arg.slice(6).toLowerCase();
+      if (!SUPPORTED_IDES.includes(ide)) {
+        console.error(colors.red(`Error: Unknown IDE '${ide}'`));
+        console.error(colors.dim(`Supported: ${SUPPORTED_IDES.join(', ')}`));
+        process.exit(1);
+      }
+      if (!ides.includes(ide)) {
+        ides.push(ide);
+      }
+    } else if (arg.startsWith('-')) {
+      console.error(colors.red(`Error: Unknown option '${arg}'`));
+      printHelp();
+      process.exit(1);
+    } else {
+      templates.push(arg);
     }
   }
 
   printBanner();
 
-  // Validate
+  // Use default IDEs if none specified
+  const targetIdes = ides.length > 0 ? ides : DEFAULT_IDES;
+
+  // Handle reset mode
+  if (resetMode) {
+    if (removeMode) {
+      console.error(colors.red('Error: Cannot use --remove and --reset together\n'));
+      process.exit(1);
+    }
+    if (templates.length > 0) {
+      console.error(colors.red('Error: --reset does not accept template arguments\n'));
+      console.error(colors.dim('Use --remove <templates...> to remove specific templates.\n'));
+      process.exit(1);
+    }
+
+    if (dryRun) {
+      console.log(colors.yellow('DRY RUN - No changes will be made\n'));
+    }
+    if (force) {
+      console.log(colors.yellow('FORCE MODE - Modified files will be removed\n'));
+    }
+
+    await reset(process.cwd(), dryRun, force, skipConfirm, targetIdes);
+    return;
+  }
+
+  // Handle remove mode
+  if (removeMode) {
+    if (templates.length === 0) {
+      console.error(colors.red('Error: No templates specified for removal\n'));
+      console.error(colors.dim('Usage: npx cursor-templates --remove <templates...>\n'));
+      printTemplates();
+      process.exit(1);
+    }
+
+    for (const template of templates) {
+      if (!TEMPLATES[template]) {
+        console.error(colors.red(`Error: Unknown template '${template}'\n`));
+        printTemplates();
+        process.exit(1);
+      }
+    }
+
+    if (dryRun) {
+      console.log(colors.yellow('DRY RUN - No changes will be made\n'));
+    }
+    if (force) {
+      console.log(colors.yellow('FORCE MODE - Modified files will be removed\n'));
+    }
+
+    await remove(process.cwd(), templates, dryRun, force, skipConfirm, targetIdes);
+    return;
+  }
+
+  // Install mode (default)
   if (templates.length === 0) {
     console.error(colors.red('Error: No templates specified\n'));
     printHelp();
@@ -713,5 +1334,26 @@ export function run(args) {
   }
 
   // Install to current directory
-  install(process.cwd(), templates, dryRun, force);
+  install(process.cwd(), templates, dryRun, force, targetIdes);
 }
+
+// Export internals for testing
+export const _internals = {
+  TEMPLATES,
+  SHARED_RULES,
+  SUPPORTED_IDES,
+  DEFAULT_IDES,
+  filesMatch,
+  parseMarkdownSections,
+  generateSectionSignature,
+  findMissingSections,
+  mergeClaudeContent,
+  getAlternateFilename,
+  copyFile,
+  generateClaudeMdContent,
+  generateCopilotInstructionsContent,
+  isOurFile,
+  install,
+  remove,
+  reset,
+};