agent-configs 1.0.0

package/cli.js

@@ -0,0 +1,978 @@
+#!/usr/bin/env node
+
+/**
+ * agent-configs CLI
+ * 
+ * Interactive CLI tool for installing Claude Code and Cursor configurations.
+ * 
+ * Usage:
+ *   npx agent-configs              # Interactive mode
+ *   npx agent-configs list         # Interactive category browser
+ *   npx agent-configs install <name> [--agent <platform>] [--scope <scope>]
+ *   npx agent-configs uninstall <name> [--agent <platform>]
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const readline = require('readline');
+const { select, Separator } = require('@inquirer/prompts');
+
+// Terminal colors
+const colors = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+  red: '\x1b[31m',
+  magenta: '\x1b[35m',
+};
+
+// Load configs.json
+function loadConfigs() {
+  const configsPath = path.join(__dirname, 'configs.json');
+  return JSON.parse(fs.readFileSync(configsPath, 'utf8'));
+}
+
+// Platform paths
+const PLATFORM_PATHS = {
+  claude: {
+    global: {
+      commands: path.join(os.homedir(), '.claude', 'commands'),
+      skills: path.join(os.homedir(), '.claude', 'skills'),
+      agents: path.join(os.homedir(), '.claude', 'agents'),
+      settings: path.join(os.homedir(), '.claude', 'settings.json'),
+    },
+    project: {
+      commands: '.claude/commands',
+      skills: '.claude/skills',
+      agents: '.claude/agents',
+      settings: '.claude/settings.json',
+    }
+  },
+  cursor: {
+    global: {
+      commands: path.join(os.homedir(), '.cursor', 'commands'),
+      skills: path.join(os.homedir(), '.cursor', 'skills'),
+      agents: path.join(os.homedir(), '.cursor', 'agents'),
+    },
+    project: {
+      commands: '.cursor/commands',
+      skills: '.cursor/skills',
+      agents: '.cursor/agents',
+      rules: '.cursor/rules',
+      hooks: '.cursor/hooks.json',
+    }
+  }
+};
+
+// Copy file or directory
+function copyRecursive(src, dest) {
+  const stat = fs.statSync(src);
+  
+  if (stat.isDirectory()) {
+    if (!fs.existsSync(dest)) {
+      fs.mkdirSync(dest, { recursive: true });
+    }
+    const entries = fs.readdirSync(src);
+    for (const entry of entries) {
+      copyRecursive(path.join(src, entry), path.join(dest, entry));
+    }
+  } else {
+    const destDir = path.dirname(dest);
+    if (!fs.existsSync(destDir)) {
+      fs.mkdirSync(destDir, { recursive: true });
+    }
+    fs.copyFileSync(src, dest);
+  }
+}
+
+// Merge JSON files (for hooks/settings)
+function mergeJson(targetPath, sourceData) {
+  let existing = {};
+  if (fs.existsSync(targetPath)) {
+    try {
+      existing = JSON.parse(fs.readFileSync(targetPath, 'utf8'));
+    } catch (e) {
+      existing = {};
+    }
+  }
+  
+  // Deep merge
+  function deepMerge(target, source) {
+    for (const key in source) {
+      if (Array.isArray(source[key]) && Array.isArray(target[key])) {
+        // Merge arrays, avoiding duplicates by description
+        const existingDescs = new Set(target[key].map(h => h.description || JSON.stringify(h)));
+        for (const item of source[key]) {
+          const desc = item.description || JSON.stringify(item);
+          if (!existingDescs.has(desc)) {
+            target[key].push(item);
+          }
+        }
+      } else if (typeof source[key] === 'object' && source[key] !== null && typeof target[key] === 'object' && target[key] !== null) {
+        deepMerge(target[key], source[key]);
+      } else {
+        target[key] = source[key];
+      }
+    }
+    return target;
+  }
+  
+  const merged = deepMerge(existing, sourceData);
+  const destDir = path.dirname(targetPath);
+  if (!fs.existsSync(destDir)) {
+    fs.mkdirSync(destDir, { recursive: true });
+  }
+  fs.writeFileSync(targetPath, JSON.stringify(merged, null, 2));
+}
+
+// Delete file or directory
+function deleteRecursive(targetPath) {
+  if (!fs.existsSync(targetPath)) return false;
+  
+  const stat = fs.statSync(targetPath);
+  if (stat.isDirectory()) {
+    fs.rmSync(targetPath, { recursive: true, force: true });
+  } else {
+    fs.unlinkSync(targetPath);
+  }
+  return true;
+}
+
+// Find config item by name
+function findConfig(configs, name) {
+  for (const category of configs.categories) {
+    for (const item of category.items) {
+      if (item.name === name) {
+        return { category, item };
+      }
+    }
+  }
+  return null;
+}
+
+// List command (static output)
+function listConfigsStatic(options = {}) {
+  const configs = loadConfigs();
+  const { category: filterCategory } = options;
+  
+  console.log(`\n${colors.bold}${colors.cyan}agent-configs${colors.reset} - Claude Code & Cursor 配置共享工具\n`);
+  
+  for (const category of configs.categories) {
+    if (filterCategory && category.id !== filterCategory) continue;
+    
+    console.log(`${colors.bold}${colors.blue}${category.name}${colors.reset} (${category.items.length})`);
+    console.log(`${colors.dim}${category.description}${colors.reset}`);
+    
+    if (category.id !== 'bundles') {
+      console.log(`${colors.dim}平台: ${(category.platforms || ['claude', 'cursor']).join(', ')}${colors.reset}`);
+    }
+    console.log();
+    
+    for (const item of category.items) {
+      const featured = item.featured ? `${colors.yellow}★${colors.reset} ` : '  ';
+      const tags = item.tags ? ` ${colors.dim}[${item.tags.join(', ')}]${colors.reset}` : '';
+      console.log(`  ${featured}${colors.green}${item.name}${colors.reset} - ${item.description}${tags}`);
+    }
+    console.log();
+  }
+  
+  console.log(`${colors.dim}使用 ${colors.cyan}npx agent-configs install <name>${colors.dim} 安装配置${colors.reset}`);
+  console.log(`${colors.dim}使用 ${colors.cyan}npx agent-configs list --category bundles${colors.dim} 查看特定类别${colors.reset}\n`);
+}
+
+// Custom select menu with Esc support - optimized for performance
+async function customSelect({ message, choices, pageSize = 10 }) {
+  return new Promise((resolve) => {
+    let selectedIndex = 0;
+    const items = choices.filter(c => c.value !== undefined);
+    const allItems = choices;
+    
+    // Pre-calculate selectable indices
+    const selectableIndices = [];
+    allItems.forEach((item, idx) => {
+      if (item.value !== undefined) {
+        selectableIndices.push(idx);
+      }
+    });
+    
+    // Pre-build all line variants (selected and unselected)
+    const headerLine = `${colors.cyan}?${colors.reset} ${colors.bold}${message}${colors.reset}`;
+    const footerLine = `${colors.dim}↑↓ 导航 • ⏎ 确认 • Esc 返回${colors.reset}`;
+    const separatorLine = `${colors.dim}──────────────${colors.reset}`;
+    
+    const normalLines = [];
+    const selectedLines = [];
+    const descriptions = [];
+    
+    allItems.forEach((item, idx) => {
+      if (item.value === undefined) {
+        normalLines.push(separatorLine);
+        selectedLines.push(separatorLine);
+        descriptions.push('');
+      } else {
+        normalLines.push(`  ${item.name}`);
+        selectedLines.push(`${colors.cyan}❯ ${item.name}${colors.reset}`);
+        descriptions.push(item.description ? `${colors.dim}${item.description}${colors.reset}` : '');
+      }
+    });
+    
+    const totalLines = allItems.length + 3;
+    
+    // Build complete output buffer
+    const buildOutput = () => {
+      const lines = [headerLine];
+      for (let i = 0; i < allItems.length; i++) {
+        lines.push(selectableIndices[selectedIndex] === i ? selectedLines[i] : normalLines[i]);
+      }
+      lines.push(descriptions[selectableIndices[selectedIndex]]);
+      lines.push(footerLine);
+      return lines.join('\n');
+    };
+    
+    const render = (isFirst = false) => {
+      if (!isFirst) {
+        process.stdout.write(`\x1b[${totalLines}A\x1b[J`);
+      }
+      process.stdout.write(buildOutput() + '\n');
+    };
+    
+    // Setup keyboard input - use raw data handler for faster Esc response
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+    }
+    process.stdin.resume();
+    
+    // Direct data handler - faster than readline keypress events for Esc
+    const dataHandler = (data) => {
+      const input = data.toString();
+      
+      // Esc key (single byte 0x1b, not followed by [ for escape sequences)
+      if (input === '\x1b' || input === '\u001b') {
+        cleanup();
+        resolve('__escape__');
+        return;
+      }
+      
+      // Arrow keys: Esc + [ + A/B/C/D
+      if (input === '\x1b[A' || input === '\u001b[A') { // Up
+        if (selectedIndex > 0) {
+          selectedIndex--;
+          render();
+        }
+        return;
+      }
+      if (input === '\x1b[B' || input === '\u001b[B') { // Down
+        if (selectedIndex < items.length - 1) {
+          selectedIndex++;
+          render();
+        }
+        return;
+      }
+      
+      // Enter key
+      if (input === '\r' || input === '\n') {
+        cleanup();
+        resolve(items[selectedIndex].value);
+        return;
+      }
+      
+      // k/j for vim-style navigation
+      if (input === 'k') {
+        if (selectedIndex > 0) {
+          selectedIndex--;
+          render();
+        }
+        return;
+      }
+      if (input === 'j') {
+        if (selectedIndex < items.length - 1) {
+          selectedIndex++;
+          render();
+        }
+        return;
+      }
+      
+      // Ctrl+C
+      if (input === '\x03') {
+        cleanup();
+        process.exit(0);
+      }
+    };
+    
+    const cleanup = () => {
+      process.stdin.removeListener('data', dataHandler);
+      if (process.stdin.isTTY) {
+        process.stdin.setRawMode(false);
+      }
+      process.stdin.pause();
+      process.stdout.write('\x1b[?25h');
+    };
+    
+    process.stdin.on('data', dataHandler);
+    process.stdout.write('\x1b[?25l');
+    render(true);
+  });
+}
+
+// Interactive menu - Main category selection
+async function interactiveMenu(options = {}) {
+  const configs = loadConfigs();
+  
+  console.clear();
+  console.log(`\n${colors.bold}${colors.cyan}agent-configs${colors.reset} - Claude Code & Cursor 配置共享工具\n`);
+  console.log(`${colors.dim}使用 ↑↓ 选择，Enter 进入，Esc 退出${colors.reset}\n`);
+  
+  while (true) {
+    try {
+      // Build category choices
+      const categoryChoices = configs.categories.map(cat => {
+        const featuredCount = cat.items.filter(i => i.featured).length;
+        const featuredMark = featuredCount > 0 ? ` ${colors.yellow}★${featuredCount}${colors.reset}` : '';
+        const platformInfo = cat.id !== 'bundles' && cat.platforms 
+          ? ` ${colors.dim}(${cat.platforms.join('/')})${colors.reset}` 
+          : '';
+        
+        return {
+          name: `${colors.blue}${cat.name}${colors.reset} (${cat.items.length})${featuredMark}${platformInfo}`,
+          value: cat.id,
+          description: cat.description
+        };
+      });
+      
+      categoryChoices.push(new Separator());
+      categoryChoices.push({
+        name: `${colors.dim}退出${colors.reset}`,
+        value: '__exit__'
+      });
+      
+      const selectedCategory = await customSelect({
+        message: '选择类别',
+        choices: categoryChoices,
+        pageSize: 10
+      });
+      
+      if (selectedCategory === '__exit__' || selectedCategory === '__escape__') {
+        console.log(`\n${colors.dim}再见！${colors.reset}\n`);
+        break;
+      }
+      
+      // Enter category submenu
+      await categorySubMenu(configs, selectedCategory, options);
+      
+    } catch (error) {
+      if (error.message?.includes('User force closed') || error.name === 'ExitPromptError') {
+        console.log(`\n${colors.dim}再见！${colors.reset}\n`);
+        break;
+      }
+      throw error;
+    }
+  }
+}
+
+// Interactive menu - Category items
+async function categorySubMenu(configs, categoryId, options = {}) {
+  const category = configs.categories.find(c => c.id === categoryId);
+  if (!category) return;
+  
+  while (true) {
+    try {
+      console.clear();
+      console.log(`\n${colors.bold}${colors.cyan}agent-configs${colors.reset} > ${colors.blue}${category.name}${colors.reset}\n`);
+      console.log(`${colors.dim}${category.description}${colors.reset}`);
+      if (category.id !== 'bundles' && category.platforms) {
+        console.log(`${colors.dim}平台: ${category.platforms.join(', ')}${colors.reset}`);
+      }
+      console.log(`${colors.dim}使用 ↑↓ 选择，Enter 安装，Esc 返回${colors.reset}\n`);
+      
+      // Build item choices
+      const itemChoices = category.items.map(item => {
+        const featured = item.featured ? `${colors.yellow}★${colors.reset} ` : '  ';
+        const tags = item.tags ? ` ${colors.dim}[${item.tags.join(', ')}]${colors.reset}` : '';
+        
+        return {
+          name: `${featured}${colors.green}${item.name}${colors.reset}${tags}`,
+          value: item.name,
+          description: item.description
+        };
+      });
+      
+      itemChoices.push(new Separator());
+      itemChoices.push({
+        name: `${colors.dim}← 返回${colors.reset}`,
+        value: '__back__'
+      });
+      
+      const selectedItem = await customSelect({
+        message: `选择配置`,
+        choices: itemChoices,
+        pageSize: 15
+      });
+      
+      if (selectedItem === '__back__' || selectedItem === '__escape__') {
+        console.clear();
+        console.log(`\n${colors.bold}${colors.cyan}agent-configs${colors.reset} - Claude Code & Cursor 配置共享工具\n`);
+        console.log(`${colors.dim}使用 ↑↓ 选择，Enter 进入，Esc 退出${colors.reset}\n`);
+        return;
+      }
+      
+      // Show install options
+      await installSubMenu(selectedItem, category, options);
+      
+    } catch (error) {
+      if (error.message?.includes('User force closed') || error.name === 'ExitPromptError') {
+        console.clear();
+        console.log(`\n${colors.bold}${colors.cyan}agent-configs${colors.reset} - Claude Code & Cursor 配置共享工具\n`);
+        console.log(`${colors.dim}使用 ↑↓ 选择，Enter 进入，Esc 退出${colors.reset}\n`);
+        return;
+      }
+      throw error;
+    }
+  }
+}
+
+// Interactive menu - Install options
+async function installSubMenu(itemName, category, options = {}) {
+  const item = category.items.find(i => i.name === itemName);
+  if (!item) return;
+  
+  try {
+    console.clear();
+    console.log(`\n${colors.bold}${colors.cyan}agent-configs${colors.reset} > ${colors.blue}${category.name}${colors.reset} > ${colors.green}${item.name}${colors.reset}\n`);
+    console.log(`${colors.dim}${item.description}${colors.reset}`);
+    if (item.tags) {
+      console.log(`${colors.dim}标签: ${item.tags.join(', ')}${colors.reset}`);
+    }
+    if (item.includes) {
+      console.log(`${colors.dim}包含: ${item.includes.join(', ')}${colors.reset}`);
+    }
+    console.log();
+    
+    // Build action choices based on category
+    const actionChoices = [];
+    
+    // Determine available platforms
+    const platforms = category.platforms || ['claude', 'cursor'];
+    
+    if (platforms.includes('cursor')) {
+      actionChoices.push({
+        name: `${colors.green}安装到 Cursor${colors.reset} ${colors.dim}(项目级别)${colors.reset}`,
+        value: 'install_cursor_project'
+      });
+      actionChoices.push({
+        name: `${colors.cyan}安装到 Cursor${colors.reset} ${colors.dim}(全局)${colors.reset}`,
+        value: 'install_cursor_global'
+      });
+    }
+    
+    if (platforms.includes('claude')) {
+      actionChoices.push({
+        name: `${colors.green}安装到 Claude Code${colors.reset} ${colors.dim}(项目级别)${colors.reset}`,
+        value: 'install_claude_project'
+      });
+      actionChoices.push({
+        name: `${colors.cyan}安装到 Claude Code${colors.reset} ${colors.dim}(全局)${colors.reset}`,
+        value: 'install_claude_global'
+      });
+    }
+    
+    if (platforms.length === 2) {
+      actionChoices.push(new Separator());
+      actionChoices.push({
+        name: `${colors.magenta}安装到所有平台${colors.reset} ${colors.dim}(项目级别)${colors.reset}`,
+        value: 'install_all_project'
+      });
+    }
+    
+    actionChoices.push(new Separator());
+    actionChoices.push({
+      name: `${colors.dim}← 返回${colors.reset}`,
+      value: '__back__'
+    });
+    
+    const action = await customSelect({
+      message: '选择操作',
+      choices: actionChoices,
+      pageSize: 10
+    });
+    
+    if (action === '__back__' || action === '__escape__') {
+      return;
+    }
+    
+    // Parse action
+    const [, platform, scope] = action.split('_');
+    
+    console.log();
+    installConfig(item.name, { 
+      agent: platform, 
+      scope: scope,
+      ...options 
+    });
+    
+    // Wait for user to see result
+    console.log(`${colors.dim}按任意键继续...${colors.reset}`);
+    await waitForKey();
+    
+  } catch (error) {
+    if (error.message?.includes('User force closed') || error.name === 'ExitPromptError') {
+      return;
+    }
+    throw error;
+  }
+}
+
+// Wait for any key press
+function waitForKey() {
+  return new Promise(resolve => {
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+      process.stdin.resume();
+      process.stdin.once('data', () => {
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        resolve();
+      });
+    } else {
+      resolve();
+    }
+  });
+}
+
+// Install command
+function installConfig(name, options = {}) {
+  const configs = loadConfigs();
+  const platform = options.agent || configs.defaultPlatform || 'cursor';
+  const scope = options.scope || configs.defaultScope || 'project';
+  const dryRun = options.dryRun || false;
+  
+  // Handle 'all' platform
+  const platforms = platform === 'all' ? ['claude', 'cursor'] : [platform];
+  
+  // Find config
+  const found = findConfig(configs, name);
+  if (!found) {
+    console.error(`${colors.red}Error: Config '${name}' not found${colors.reset}`);
+    console.log(`${colors.dim}Use 'npx agent-configs list' to see available configs${colors.reset}`);
+    process.exit(1);
+  }
+  
+  const { category, item } = found;
+  
+  console.log(`\n${colors.bold}Installing ${colors.green}${item.name}${colors.reset}${colors.bold}...${colors.reset}\n`);
+  
+  // Handle bundles
+  if (category.id === 'bundles') {
+    if (item.hasFiles) {
+      // File-based bundle (like shared-memory)
+      installFileBundle(item, platforms, scope, dryRun);
+    } else if (item.includes) {
+      // Reference bundle
+      installReferenceBundle(item, configs, platforms, scope, dryRun);
+    }
+    return;
+  }
+  
+  // Handle hooks (special case)
+  if (category.id === 'hooks') {
+    installHooks(item, platforms, scope, dryRun);
+    return;
+  }
+  
+  // Regular config installation
+  for (const p of platforms) {
+    if (!category.platforms || !category.platforms.includes(p)) {
+      console.log(`${colors.yellow}⚠ ${item.name} not supported on ${p}, skipping${colors.reset}`);
+      continue;
+    }
+    
+    const targetBase = PLATFORM_PATHS[p][scope];
+    if (!targetBase) {
+      console.log(`${colors.yellow}⚠ ${scope} scope not supported on ${p}, skipping${colors.reset}`);
+      continue;
+    }
+    
+    const categoryPath = targetBase[category.id] || targetBase[category.id.replace(/s$/, '')];
+    if (!categoryPath) {
+      console.log(`${colors.yellow}⚠ ${category.id} not supported on ${p}, skipping${colors.reset}`);
+      continue;
+    }
+    
+    const sourcePath = path.join(__dirname, item.path);
+    const isDir = fs.statSync(sourcePath).isDirectory();
+    const targetPath = isDir 
+      ? path.join(categoryPath, item.name)
+      : path.join(categoryPath, path.basename(item.path));
+    
+    if (dryRun) {
+      console.log(`${colors.dim}[dry-run]${colors.reset} Would copy ${sourcePath} -> ${targetPath}`);
+    } else {
+      copyRecursive(sourcePath, targetPath);
+      console.log(`${colors.green}✓${colors.reset} Installed to ${targetPath}`);
+    }
+  }
+  
+  console.log();
+}
+
+// Install file-based bundle
+function installFileBundle(item, platforms, scope, dryRun) {
+  const bundlePath = path.join(__dirname, item.path);
+  
+  for (const p of platforms) {
+    const platformDir = path.join(bundlePath, `.${p}`);
+    if (!fs.existsSync(platformDir)) {
+      console.log(`${colors.yellow}⚠ No ${p} config in ${item.name} bundle${colors.reset}`);
+      continue;
+    }
+    
+    const entries = fs.readdirSync(platformDir);
+    for (const entry of entries) {
+      const sourcePath = path.join(platformDir, entry);
+      let targetPath;
+      
+      if (scope === 'global') {
+        targetPath = path.join(os.homedir(), `.${p}`, entry);
+      } else {
+        targetPath = path.join(`.${p}`, entry);
+      }
+      
+      if (dryRun) {
+        console.log(`${colors.dim}[dry-run]${colors.reset} Would copy ${sourcePath} -> ${targetPath}`);
+      } else {
+        copyRecursive(sourcePath, targetPath);
+        console.log(`${colors.green}✓${colors.reset} Installed ${entry} to ${targetPath}`);
+      }
+    }
+  }
+  
+  console.log(`\n${colors.green}✓${colors.reset} Bundle ${colors.bold}${item.name}${colors.reset} installed successfully\n`);
+}
+
+// Install reference bundle
+function installReferenceBundle(item, configs, platforms, scope, dryRun) {
+  console.log(`${colors.dim}Bundle includes: ${item.includes.join(', ')}${colors.reset}\n`);
+  
+  for (const ref of item.includes) {
+    const [categoryId, configName] = ref.split('/');
+    
+    // Find the config
+    const category = configs.categories.find(c => c.id === categoryId);
+    if (!category) {
+      console.log(`${colors.yellow}⚠ Category '${categoryId}' not found${colors.reset}`);
+      continue;
+    }
+    
+    const configItem = category.items.find(i => i.name === configName);
+    if (!configItem) {
+      console.log(`${colors.yellow}⚠ Config '${configName}' not found in ${categoryId}${colors.reset}`);
+      continue;
+    }
+    
+    // Install the referenced config
+    for (const p of platforms) {
+      if (category.platforms && !category.platforms.includes(p)) {
+        continue;
+      }
+      
+      const targetBase = PLATFORM_PATHS[p][scope];
+      if (!targetBase) continue;
+      
+      const categoryPath = targetBase[categoryId] || targetBase[categoryId.replace(/s$/, '')];
+      if (!categoryPath) continue;
+      
+      const sourcePath = path.join(__dirname, configItem.path);
+      const isDir = fs.existsSync(sourcePath) && fs.statSync(sourcePath).isDirectory();
+      const targetPath = isDir 
+        ? path.join(categoryPath, configItem.name)
+        : path.join(categoryPath, path.basename(configItem.path));
+      
+      if (dryRun) {
+        console.log(`${colors.dim}[dry-run]${colors.reset} Would copy ${sourcePath} -> ${targetPath}`);
+      } else {
+        copyRecursive(sourcePath, targetPath);
+        console.log(`${colors.green}✓${colors.reset} Installed ${configItem.name} to ${targetPath}`);
+      }
+    }
+  }
+  
+  console.log(`\n${colors.green}✓${colors.reset} Bundle ${colors.bold}${item.name}${colors.reset} installed successfully\n`);
+}
+
+// Install hooks
+function installHooks(item, platforms, scope, dryRun) {
+  const sourceFile = path.join(__dirname, 'hooks/hooks.json');
+  const sourceData = JSON.parse(fs.readFileSync(sourceFile, 'utf8'));
+  
+  for (const p of platforms) {
+    let targetPath;
+    if (p === 'claude') {
+      targetPath = scope === 'global' 
+        ? PLATFORM_PATHS.claude.global.settings
+        : PLATFORM_PATHS.claude.project.settings;
+    } else {
+      targetPath = scope === 'global'
+        ? path.join(os.homedir(), '.cursor', 'hooks.json')
+        : PLATFORM_PATHS.cursor.project.hooks;
+    }
+    
+    if (dryRun) {
+      console.log(`${colors.dim}[dry-run]${colors.reset} Would merge hooks into ${targetPath}`);
+    } else {
+      mergeJson(targetPath, sourceData);
+      console.log(`${colors.green}✓${colors.reset} Merged hooks into ${targetPath}`);
+    }
+  }
+  
+  console.log();
+}
+
+// Uninstall command
+function uninstallConfig(name, options = {}) {
+  const configs = loadConfigs();
+  const platform = options.agent || configs.defaultPlatform || 'cursor';
+  const scope = options.scope || configs.defaultScope || 'project';
+  
+  const platforms = platform === 'all' ? ['claude', 'cursor'] : [platform];
+  
+  const found = findConfig(configs, name);
+  if (!found) {
+    console.error(`${colors.red}Error: Config '${name}' not found${colors.reset}`);
+    process.exit(1);
+  }
+  
+  const { category, item } = found;
+  
+  console.log(`\n${colors.bold}Uninstalling ${colors.red}${item.name}${colors.reset}${colors.bold}...${colors.reset}\n`);
+  
+  // Handle bundles with includes
+  if (category.id === 'bundles' && item.includes) {
+    for (const ref of item.includes) {
+      const [categoryId, configName] = ref.split('/');
+      const cat = configs.categories.find(c => c.id === categoryId);
+      if (!cat) continue;
+      
+      const configItem = cat.items.find(i => i.name === configName);
+      if (!configItem) continue;
+      
+      for (const p of platforms) {
+        const targetBase = PLATFORM_PATHS[p][scope];
+        if (!targetBase) continue;
+        
+        const categoryPath = targetBase[categoryId];
+        if (!categoryPath) continue;
+        
+        const isDir = configItem.path.endsWith('/');
+        const targetPath = isDir 
+          ? path.join(categoryPath, configItem.name)
+          : path.join(categoryPath, path.basename(configItem.path));
+        
+        if (deleteRecursive(targetPath)) {
+          console.log(`${colors.red}✗${colors.reset} Removed ${targetPath}`);
+        }
+      }
+    }
+    console.log();
+    return;
+  }
+  
+  // Regular uninstall
+  for (const p of platforms) {
+    const targetBase = PLATFORM_PATHS[p][scope];
+    if (!targetBase) continue;
+    
+    const categoryPath = targetBase[category.id];
+    if (!categoryPath) continue;
+    
+    const isDir = item.path.endsWith('/');
+    const targetPath = isDir 
+      ? path.join(categoryPath, item.name)
+      : path.join(categoryPath, path.basename(item.path));
+    
+    if (deleteRecursive(targetPath)) {
+      console.log(`${colors.red}✗${colors.reset} Removed ${targetPath}`);
+    } else {
+      console.log(`${colors.dim}Not found: ${targetPath}${colors.reset}`);
+    }
+  }
+  
+  console.log();
+}
+
+// Show help
+function showHelp() {
+  console.log(`
+${colors.bold}${colors.cyan}agent-configs${colors.reset} - Claude Code & Cursor 配置共享工具
+
+${colors.bold}Usage:${colors.reset}
+  npx agent-configs                    ${colors.dim}# 交互式菜单${colors.reset}
+  npx agent-configs <command> [options]
+
+${colors.bold}Commands:${colors.reset}
+  ${colors.green}(无)${colors.reset}                    进入交互式菜单
+  ${colors.green}list${colors.reset}                    交互式浏览配置
+  ${colors.green}list --static${colors.reset}           静态列表输出
+  ${colors.green}install${colors.reset} <name>         安装指定配置
+  ${colors.green}uninstall${colors.reset} <name>       卸载配置
+
+${colors.bold}Options:${colors.reset}
+  --static                静态输出模式（不进入交互）
+  --category <cat>        过滤类别: commands, skills, rules, agents, bundles
+  --agent <platform>      目标平台: cursor (默认), claude, all
+  --scope <scope>         安装级别: project (默认), global
+  --dry-run               预览模式，不实际执行
+  --preset <name>         预设方案: minimal, recommended, full
+
+${colors.bold}Interactive Mode:${colors.reset}
+  ↑↓                      上下选择
+  Enter                   进入子菜单 / 安装
+  Esc                     返回上一层 / 退出
+
+${colors.bold}Examples:${colors.reset}
+  npx agent-configs                     ${colors.dim}# 交互式选择${colors.reset}
+  npx agent-configs list --static       ${colors.dim}# 静态列表${colors.reset}
+  npx agent-configs install plan        ${colors.dim}# 直接安装${colors.reset}
+  npx agent-configs install --preset recommended
+
+${colors.bold}Bundles (推荐):${colors.reset}
+  ${colors.green}tdd-bundle${colors.reset}        TDD 完整工作流
+  ${colors.green}review-bundle${colors.reset}     代码审查全套
+  ${colors.green}planning-bundle${colors.reset}   规划和架构设计
+  ${colors.green}bk-chat-bundle${colors.reset}    蓝鲸 AI Chat 开发
+  ${colors.green}shared-memory${colors.reset}     跨会话记忆系统
+`);
+}
+
+// Install preset
+function installPreset(presetName, options = {}) {
+  const configs = loadConfigs();
+  const preset = configs.presets[presetName];
+  
+  if (!preset) {
+    console.error(`${colors.red}Error: Preset '${presetName}' not found${colors.reset}`);
+    console.log(`${colors.dim}Available presets: ${Object.keys(configs.presets).join(', ')}${colors.reset}`);
+    process.exit(1);
+  }
+  
+  console.log(`\n${colors.bold}Installing preset ${colors.cyan}${presetName}${colors.reset}${colors.bold}...${colors.reset}\n`);
+  
+  for (const pattern of preset) {
+    if (pattern === '*') {
+      // Install everything
+      for (const category of configs.categories) {
+        for (const item of category.items) {
+          installConfig(item.name, options);
+        }
+      }
+    } else if (pattern.endsWith('/*')) {
+      // Install all in category
+      const categoryId = pattern.replace('/*', '');
+      const category = configs.categories.find(c => c.id === categoryId);
+      if (category) {
+        for (const item of category.items) {
+          installConfig(item.name, options);
+        }
+      }
+    } else {
+      // Install specific config
+      const configName = pattern.split('/').pop();
+      installConfig(configName, options);
+    }
+  }
+}
+
+// Parse arguments
+function parseArgs(args) {
+  const result = { _: [], options: {} };
+  
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2);
+      if (key === 'dry-run') {
+        result.options.dryRun = true;
+      } else if (i + 1 < args.length && !args[i + 1].startsWith('-')) {
+        result.options[key] = args[++i];
+      } else {
+        result.options[key] = true;
+      }
+    } else if (arg.startsWith('-') && arg.length === 2) {
+      // Short flags like -h
+      const key = arg.slice(1);
+      result.options[key] = true;
+    } else {
+      result._.push(arg);
+    }
+  }
+  
+  return result;
+}
+
+// Main entry
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const command = args._[0];
+  const name = args._[1];
+  
+  // Handle --help and -h flags
+  if (args.options.help || args.options.h) {
+    showHelp();
+    return;
+  }
+  
+  switch (command) {
+    case 'list':
+    case 'ls':
+      if (args.options.static) {
+        // Static output mode
+        listConfigsStatic({ category: args.options.category });
+      } else if (args.options.category) {
+        // Filter by category but still static
+        listConfigsStatic({ category: args.options.category });
+      } else {
+        // Interactive mode
+        await interactiveMenu(args.options);
+      }
+      break;
+    
+    case 'install':
+    case 'i':
+      if (args.options.preset) {
+        installPreset(args.options.preset, args.options);
+      } else if (name) {
+        installConfig(name, args.options);
+      } else {
+        // No name specified, enter interactive mode
+        await interactiveMenu(args.options);
+      }
+      break;
+    
+    case 'uninstall':
+    case 'rm':
+      if (name) {
+        uninstallConfig(name, args.options);
+      } else {
+        console.error(`${colors.red}Error: Please specify a config name${colors.reset}`);
+        process.exit(1);
+      }
+      break;
+    
+    case 'help':
+      showHelp();
+      break;
+    
+    default:
+      // No command, enter interactive mode
+      await interactiveMenu(args.options);
+      break;
+  }
+}
+
+main().catch(err => {
+  console.error(`${colors.red}Error: ${err.message}${colors.reset}`);
+  process.exit(1);
+});