@halilertekin/claude-code-router-config 1.2.2 → 1.3.3

package/NPM_README.md

@@ -0,0 +1,165 @@
+# Claude Code Router Config
+
+[![npm version](https://badge.fury.io/js/@halilertekin%2Fclaude-code-router-config.svg)](https://badge.fury.io/js/@halilertekin%2Fclaude-code-router-config)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Multi-provider configuration for Claude Code Router with intelligent intent-based routing.
+
+## Quick Install
+
+```bash
+npm install -g claude-code-router-config
+ccr-setup
+```
+
+## Features
+
+- **🤖 7 AI Providers**: OpenAI, Anthropic, Gemini, Qwen, GLM, OpenRouter, GitHub Copilot
+- **🎯 Smart Routing**: Automatically selects the best model based on your request
+- **💰 Cost Optimized**: Simple tasks use cheaper models
+- **⚡ Performance**: Fast responses use optimized models
+- **🛠️ Easy Setup**: One-command installation
+- **📝 Environment Support**: `.env` file support
+
+## Installation
+
+```bash
+npm install -g @halilertekin/claude-code-router-config
+ccr-setup
+```
+
+### Option 2: Homebrew
+
+```bash
+brew install claude-code-router-config
+```
+
+### Option 3: Manual
+
+```bash
+git clone https://github.com/YOUR_USERNAME/claude-code-router-config.git
+cd claude-code-router-config
+chmod +x install.sh
+./install.sh
+```
+
+## Setup
+
+After installation:
+
+1. **Edit API keys** in `~/.env`:
+   ```bash
+   nano ~/.env
+   ```
+
+2. **Add to shell** (`~/.zshrc` or `~/.bashrc`):
+   ```bash
+   # Load .env variables
+   export $(cat ~/.env | xargs)
+
+   # Router connection
+   export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
+   export NO_PROXY="127.0.0.1"
+   ```
+
+3. **Reload shell**:
+   ```bash
+   source ~/.zshrc
+   ```
+
+4. **Start router**:
+   ```bash
+   ccr code
+   ```
+
+## API Keys
+
+Get your API keys:
+
+| Provider | Link |
+|----------|------|
+| OpenAI | https://platform.openai.com/api-keys |
+| Anthropic | https://console.anthropic.com/settings/keys |
+| Gemini | https://aistudio.google.com/apikey |
+| Qwen | https://dashscope.console.aliyun.com/apiKey |
+| GLM | https://open.bigmodel.cn/usercenter/apikeys |
+| OpenRouter | https://openrouter.ai/keys |
+| GitHub Copilot | https://github.com/settings/tokens |
+
+## Usage
+
+### Basic Commands
+
+```bash
+ccr start    # Start router
+ccr code     # Start with Claude Code
+ccr status   # Check status
+ccr stop     # Stop router
+```
+
+### Switch Models (Runtime)
+
+Inside Claude Code:
+
+```
+/model openai,gpt-4o
+/model anthropic,claude-sonnet-4-latest
+/model gemini,gemini-2.5-flash
+/model qwen,qwen-plus
+/model glm,glm-4.6
+/model copilot,copilot
+```
+
+### Smart Routing Examples
+
+```bash
+# Coding → OpenAI
+claude "Write a Python sorting function"
+
+# Analysis → Anthropic
+claude "Explain microservices architecture"
+
+# Quick summary → Gemini
+claude "Quick summary of REST APIs"
+
+# Simple task → Qwen
+claude "List files in directory"
+
+# Translation → GLM
+claude "Translate to Chinese: Hello"
+
+# Coding help → GitHub Copilot
+claude "Help me debug this React component"
+```
+
+## Configuration Files
+
+The installer creates:
+
+```
+~/.claude-code-router/
+├── config.json          # Provider configuration
+├── intent-router.js     # Smart routing logic
+└── logs/                # Log files
+
+~/.env                   # API keys (created from .env.example)
+```
+
+## Documentation
+
+- [Complete Documentation](https://github.com/halilertekin/claude-code-router-config/docs/FULL_DOCUMENTATION_EN.md)
+- [GitHub Repository](https://github.com/halilertekin/claude-code-router-config)
+
+## Attribution
+
+This package provides configuration for [@musistudio/claude-code-router](https://github.com/musistudio/claude-code-router), the original tool that enables Claude Code functionality with multiple AI providers.
+
+The original Claude Code Router project is developed and maintained by musistudio. This package contains pre-configured routing logic and provider configurations.
+
+## License
+
+MIT © [Halil Ertekin](https://github.com/halilertekin)
+
+---
+
+**Note**: This is a configuration package. Requires the original [@musistudio/claude-code-router](https://github.com/musistudio/claude-code-router) to function.

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.3)'));
+        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.2",
+  "version": "1.3.3",
   "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": {
@@ -28,10 +28,13 @@
     "plugins/",
     "web-dashboard/",
     "install.sh",
+    "install.js",
+    "postinstall.js",
     ".env.example",
     "docs/",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "NPM_README.md"
   ],
   "keywords": [
     "claude",
@@ -83,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"

package/postinstall.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+const chalk = require('chalk');
+
+console.log(chalk.cyan(`
+╔════════════════════════════════════════════╗
+║  Claude Code Router Config - Installed!      ║
+╚════════════════════════════════════════════╝
+
+To complete setup:
+  1. Add your API keys to ~/.env
+  2. Run: ccr-setup
+`));