@halilertekin/claude-code-router-config 1.2.3 → 1.3.4

package/NPM_README.md

@@ -23,15 +23,21 @@ ccr-setup
 
 ## Installation
 
+> [!IMPORTANT]
+> Choose only ONE installation method (Homebrew OR NPM) to avoid conflicts.
+
+### Option 1: Homebrew (Recommended for macOS)
+
 ```bash
-npm install -g @halilertekin/claude-code-router-config
-ccr-setup
+brew install halilertekin/tap/claude-code-router-config
 ```
 
-### Option 2: Homebrew
+### Option 2: NPM / PNPM
 
 ```bash
-brew install claude-code-router-config
+npm install -g @halilertekin/claude-code-router-config
+# or
+pnpm add -g @halilertekin/claude-code-router-config
 ```
 
 ### Option 3: Manual

package/README.md

@@ -66,9 +66,15 @@ ccr config template balanced                # Best of all worlds
 
 ## Installation
 
-### Option 1: Homebrew (Recommended)
+### Option 1: Homebrew (Recommended for macOS)
+
+> [!CAUTION]
+> **Conflict Warning**: Do NOT install using both Homebrew and PNPM/NPM simultaneously. Choose only ONE method to avoid command conflicts.
+
+The easiest way to install and keep updated on macOS.
 
 ```bash
+brew uninstall ccr # Remove old versions if present
 brew install halilertekin/tap/claude-code-router-config
 ```
 
@@ -77,11 +83,16 @@ After installation, edit your API keys in `~/.env` and start the router:
 ccr code
 ```
 
-### PNPM
+### Option 2: PNPM (Alternative)
+
+Use this if you are on Linux or prefer using a Node package manager.
+
+> [!WARNING]
+> If you have previously installed via Homebrew, please uninstall it first: `brew uninstall claude-code-router-config`
 
 ```bash
 pnpm add -g @halilertekin/claude-code-router-config
-ccr-setup
+# System is ready! Run: ccr --help
 ```
 
 ### Option 3: Manual Setup

package/cli/commands.js

@@ -219,71 +219,157 @@ function backupConfig() {
   }
 }
 
+// Helper to find original ccr binary
+function getOriginalCcrPath() {
+  try {
+    // Try to find it in dependencies
+    return require.resolve('@musistudio/claude-code-router/dist/cli.js');
+  } catch (e) {
+    return null;
+  }
+}
+
+// Proxy command to original router
+function proxyToOriginal(args) {
+  const originalPath = getOriginalCcrPath();
+  if (!originalPath) {
+    console.error(chalk.red('❌ Original @musistudio/claude-code-router not found.'));
+    return;
+  }
+
+  const child = spawn('node', [originalPath, ...args], {
+    stdio: 'inherit',
+    env: process.env
+  });
+
+  child.on('exit', (code) => {
+    if (code !== 0) {
+      process.exit(code || 1);
+    }
+  });
+}
+
 // CLI command handler
 async function main() {
   const [command, ...args] = process.argv.slice(2);
-
-  switch (command) {
-    case 'test':
-      const provider = args[0];
-      const model = args[1];
-      if (provider) {
-        await testProvider(provider, model);
-      } else {
-        console.error(chalk.red('❌ Please specify a provider: ccr test <provider> [model]'));
-      }
-      break;
-
-    case 'benchmark':
-      const options = {
-        allProviders: args.includes('--all'),
-        compareSpeed: args.includes('--compare-speed')
-      };
-      await benchmarkProviders(options);
-      break;
-
-    case 'status':
-      const statusOptions = {
-        detailed: args.includes('--detailed'),
-        showCosts: args.includes('--show-costs')
-      };
-      await showDetailedStatus(statusOptions);
-      break;
-
-    case 'config':
-      const configCommand = args[0];
-      switch (configCommand) {
-        case 'validate':
-          validateConfig();
-          break;
-        case 'backup':
-          backupConfig();
-          break;
-        default:
-          console.log(chalk.yellow('Available config commands:'));
-          console.log('  validate  - Check configuration validity');
-          console.log('  backup    - Backup current configuration');
-      }
-      break;
-
-    default:
-      console.log(chalk.blue('Claude Code Router - Advanced CLI'));
-      console.log(chalk.gray('─'.repeat(40)));
-      console.log(chalk.yellow('Available commands:'));
-      console.log('');
-      console.log('Testing & Benchmarking:');
-      console.log('  ccr test <provider> [model]        - Test provider connection');
-      console.log('  ccr benchmark [--all] [--compare-speed] - Benchmark providers');
-      console.log('  ccr status [--detailed] [--show-costs] - Show router status');
-      console.log('');
-      console.log('Configuration Management:');
-      console.log('  ccr config validate                 - Validate configuration');
-      console.log('  ccr config backup                   - Backup configuration');
-      console.log('');
-      console.log('Examples:');
-      console.log('  ccr test openai gpt-4o');
-      console.log('  ccr benchmark --all --compare-speed');
-      console.log('  ccr status --detailed --show-costs');
+  const advancedCommands = ['test', 'benchmark', 'analytics', 'status', 'config', 'health', 'update', 'help', 'version', '-v', '--version', '--help', '-h'];
+
+  // Check if it's an advanced command, help/version flag, or no command at all
+  const isAdvancedOrHelp = advancedCommands.includes(command) || !command;
+
+  if (isAdvancedOrHelp) {
+    switch (command) {
+      case 'update':
+        console.log(chalk.blue('🔄 Checking for updates and updating...'));
+        const updateProcess = spawn('pnpm', ['add', '-g', '@halilertekin/claude-code-router-config@latest'], {
+          stdio: 'inherit',
+          env: process.env
+        });
+        updateProcess.on('exit', (code) => {
+          if (code === 0) {
+            console.log(chalk.green('✅ Successfully updated to the latest version!'));
+          } else {
+            console.error(chalk.red(`❌ Update failed with code ${code}. Please try running manually: pnpm add -g @halilertekin/claude-code-router-config@latest`));
+          }
+        });
+        break;
+
+      case 'version':
+      case '-v':
+      case '--version':
+        const packageJson = require('../package.json');
+        console.log(chalk.blue(`v${packageJson.version}`));
+        break;
+
+      case 'test':
+        const provider = args[0];
+        const model = args[1];
+        if (provider) {
+          await testProvider(provider, model);
+        } else {
+          console.error(chalk.red('❌ Please specify a provider: ccr test <provider> [model]'));
+        }
+        break;
+
+      case 'benchmark':
+        const options = {
+          allProviders: args.includes('--all'),
+          compareSpeed: args.includes('--compare-speed')
+        };
+        await benchmarkProviders(options);
+        break;
+
+      case 'status':
+        if (args.includes('--detailed')) {
+          const statusOptions = {
+            detailed: true,
+            showCosts: args.includes('--show-costs')
+          };
+          await showDetailedStatus(statusOptions);
+        } else {
+          // Pass basic status to original router
+          proxyToOriginal(['status', ...args]);
+        }
+        break;
+
+      case 'analytics':
+        // Forward to analytics script
+        const analyticsPath = path.join(__dirname, 'analytics.js');
+        spawn('node', [analyticsPath, ...args], { stdio: 'inherit' });
+        break;
+
+      case 'health':
+        const healthPath = path.join(__dirname, '../logging/health-monitor.js');
+        spawn('node', [healthPath, ...args], { stdio: 'inherit' });
+        break;
+
+      case 'config':
+        const configCommand = args[0];
+        switch (configCommand) {
+          case 'validate':
+            validateConfig();
+            break;
+          case 'backup':
+            backupConfig();
+            break;
+          default:
+            console.log(chalk.yellow('Available config commands:'));
+            console.log('  validate  - Check configuration validity');
+            console.log('  backup    - Backup current configuration');
+        }
+        break;
+
+      default:
+        // Handles 'help', '--help', '-h' and empty command
+        console.log(chalk.blue('Claude Code Router - Advanced CLI (v1.3.4)'));
+        console.log(chalk.gray('─'.repeat(45)));
+
+        console.log(chalk.yellow('🚀 Advanced CLI Tools:'));
+        console.log('  test <provider> [model]        - Test provider connection');
+        console.log('  benchmark [--all] [--compare-speed] - Benchmark providers');
+        console.log('  analytics [period]              - View usage statistics');
+        console.log('  status --detailed [--show-costs] - Show detailed router status');
+        console.log('  config validate                 - Validate configuration');
+        console.log('  config backup                   - Backup configuration');
+        console.log('  health [--all-providers]        - Check provider health');
+        console.log('  update                          - Update to the latest version');
+
+        console.log(chalk.yellow('\n📦 Core Router Commands (Proxy):'));
+        console.log('  start         - Start router server (Backend only)');
+        console.log('  stop          - Stop router server');
+        console.log('  restart       - Restart router server');
+        console.log('  status        - Show server status');
+        console.log('  code          - Start Router + Claude Code (Recommended)');
+        console.log('  model         - Switch models at runtime');
+        console.log('  activate      - Export env variables');
+
+        console.log(chalk.yellow('\n💡 Tip:'));
+        console.log('  To start everything at once, run: ' + chalk.cyan('ccr code'));
+        console.log('  To only start the background server, run: ' + chalk.cyan('ccr start'));
+    }
+  } else {
+    // Forward unknown commands to the original router
+    proxyToOriginal([command, ...args]);
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halilertekin/claude-code-router-config",
-  "version": "1.2.3",
+  "version": "1.3.4",
   "description": "Multi-provider configuration for Claude Code Router with intent-based routing, advanced CLI tools, analytics, and smart routing. Setup OpenAI, Anthropic, Gemini, Qwen, GLM, OpenRouter, and GitHub Copilot with intelligent routing.",
   "main": "install.js",
   "bin": {
@@ -86,7 +86,8 @@
     "fs-extra": "^11.1.1",
     "dotenv": "^16.3.1",
     "express": "^4.18.2",
-    "cors": "^2.8.5"
+    "cors": "^2.8.5",
+    "@musistudio/claude-code-router": "^1.0.73"
   },
   "devDependencies": {
     "jest": "^29.7.0"