claude-multi 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2025-01-XX
+
+### Added
+- **Provider Templates**: Built-in templates for popular AI providers
+  - GLM (智谱AI) template with GLM-4.5-air and GLM-4.6 models
+  - MiniMax template with MiniMax-M2 model
+  - Interactive provider selection with secure API key prompt
+  - CLI flags: `--provider <name>` and `--api-key <key>`
+  - Auto-configuration of base URLs, model mappings, and optimal settings
+- **Quick Start Guide**: Added quick start section with provider template examples
+
+### Changed
+- Interactive mode now prompts for provider templates before config copying
+- Enhanced instance creation flow with provider-first approach
+
 ## [0.2.0] - 2025-01-XX
 
 ### Added
@@ -45,5 +60,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for custom config and binary paths
 - Command-line interface built with Commander.js
 
+[0.3.0]: https://github.com/hmziqrs/claude-multi/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/hmziqrs/claude-multi/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/hmziqrs/claude-multi/releases/tag/v0.1.0

package/README.md

@@ -11,6 +11,7 @@ Claude Code supports multiple AI providers (Anthropic, GLM, Minimax), but switch
 - 🔄 **Multiple Instances**: Run different Claude Code configs simultaneously
 - 🎯 **Simple CLI**: Easy-to-use commands for managing instances
 - 🔒 **Isolated Configs**: Each instance has its own settings and history
+- 🎨 **Provider Templates**: Built-in templates for GLM, MiniMax, and more
 - ✅ **Legal**: Uses wrapper scripts, no code modification
 - 🚀 **Auto-sync**: Always uses the latest official Claude Code
 
@@ -27,6 +28,31 @@ bun run build
 npm link
 ```
 
+## Quick Start
+
+Get started with a provider template in 30 seconds:
+
+```bash
+# Install claude-multi
+npm link  # or npm install -g claude-multi
+
+# Create a GLM instance
+claude-multi add glm --provider glm --api-key "your-glm-api-key"
+
+# Use it!
+claude-glm --help
+```
+
+**Or use interactive mode:**
+
+```bash
+claude-multi add myinstance
+# Choose "Yes" when asked about provider templates
+# Select GLM or MiniMax
+# Enter your API key
+# Done!
+```
+
 ### Windows Setup
 
 On Windows, ensure `%APPDATA%\npm` is in your PATH to use the wrapper commands:
@@ -46,9 +72,13 @@ After adding to PATH, restart your terminal for changes to take effect.
 ### Create instances
 
 ```bash
-# Create instance (interactive - prompts for copying settings)
+# Create instance (interactive - prompts for provider templates and copying settings)
 claude-multi add glm
 
+# Create instance with provider template (CLI mode)
+claude-multi add glm --provider glm --api-key "your-api-key-here"
+claude-multi add minimax --provider minimax --api-key "your-api-key-here"
+
 # Create instance with custom config path
 claude-multi add work --config ~/configs/claude-work
 
@@ -61,11 +91,18 @@ claude-multi add glm --copy-all           # Copy all files (settings, CLAUDE.md,
 claude-multi add glm --skip-prompts       # Start fresh, no prompts
 ```
 
+**Provider Templates:**
+- **GLM (智谱AI)**: GLM-4.5-air and GLM-4.6 models via z.ai
+- **MiniMax**: MiniMax-M2 model via minimax.io
+
 **Interactive prompt options:**
+- **Provider templates**: Choose GLM, MiniMax, or None/Custom
 - **Nothing - start fresh**: Empty config directory
 - **Only settings.json**: Copy your settings (API keys, preferences)
 - **All files**: Copy settings, CLAUDE.md, plugins, etc. (excludes history, debug logs)
 
+When using a provider template, you'll be prompted to enter your API key securely.
+
 ### Use instances
 
 Each instance gets its own command:
@@ -130,13 +167,20 @@ claude-personal  # Personal projects
 claude-work      # Work projects
 ```
 
-### Paid + Free Providers
+### Different AI Providers
 ```bash
-claude-multi add anthropic  # Paid subscription
-claude-multi add glm        # Free GLM API
-
-claude-anthropic  # High-quality, paid
-claude-glm        # Free tier
+# Interactive mode with provider template
+claude-multi add anthropic  # Use Anthropic (prompted for API key)
+claude-multi add glm        # Use GLM template (prompted for API key)
+claude-multi add minimax    # Use MiniMax template (prompted for API key)
+
+# CLI mode with provider template
+claude-multi add glm --provider glm --api-key "sk-..."
+claude-multi add minimax --provider minimax --api-key "sk-..."
+
+claude-anthropic  # Uses Anthropic Claude
+claude-glm        # Uses GLM-4.6
+claude-minimax    # Uses MiniMax-M2
 ```
 
 ### Multiple Environments
@@ -148,6 +192,29 @@ claude-multi add dev
 # Different configs for each
 ```
 
+## Provider Templates
+
+Built-in templates for popular AI providers. Each template auto-configures the API endpoint, model mappings, and optimal settings.
+
+### Available Providers
+
+**GLM (智谱AI)**: GLM-4.5-air and GLM-4.6 models via `api.z.ai`
+
+**MiniMax**: MiniMax-M2 model via `api.minimax.io`
+
+### Usage
+
+```bash
+# CLI mode
+claude-multi add glm --provider glm --api-key "your-api-key"
+
+# Interactive mode
+claude-multi add myinstance
+# Select provider when prompted and enter API key
+```
+
+Customize later by editing `~/.claude-{name}/settings.json`
+
 ## Development
 
 ```bash

package/dist/cli.js

@@ -7290,6 +7290,67 @@ import { existsSync, mkdirSync, readdirSync, statSync } from "node:fs";
 import { readFile, writeFile, copyFile, mkdir } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
+
+// src/templates.ts
+var PROVIDER_TEMPLATES = {
+  glm: {
+    name: "glm",
+    displayName: "GLM (智谱AI)",
+    description: "GLM-4.5 and GLM-4.6 models via z.ai",
+    settings: {
+      env: {
+        ANTHROPIC_AUTH_TOKEN: "",
+        ANTHROPIC_BASE_URL: "https://api.z.ai/api/anthropic",
+        API_TIMEOUT_MS: "3000000",
+        ANTHROPIC_DEFAULT_HAIKU_MODEL: "glm-4.5-air",
+        ANTHROPIC_DEFAULT_SONNET_MODEL: "glm-4.6",
+        ANTHROPIC_DEFAULT_OPUS_MODEL: "glm-4.6",
+        ANTHROPIC_MODEL: "glm-4.6",
+        ANTHROPIC_SMALL_FAST_MODEL: "glm-4.6-air",
+        ENABLE_THINKING: "true",
+        REASONING_EFFORT: "high",
+        MAX_THINKING_TOKENS: "8000",
+        ENABLE_STREAMING: "true",
+        MAX_OUTPUT_TOKENS: "64000"
+      },
+      includeCoAuthoredBy: false,
+      alwaysThinkingEnabled: false
+    }
+  },
+  minimax: {
+    name: "minimax",
+    displayName: "MiniMax",
+    description: "MiniMax-M2 model via minimax.io",
+    settings: {
+      env: {
+        ANTHROPIC_AUTH_TOKEN: "",
+        ANTHROPIC_BASE_URL: "https://api.minimax.io/anthropic",
+        API_TIMEOUT_MS: "3000000",
+        CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: "1",
+        ANTHROPIC_MODEL: "MiniMax-M2",
+        ANTHROPIC_SMALL_FAST_MODEL: "MiniMax-M2",
+        ANTHROPIC_DEFAULT_SONNET_MODEL: "MiniMax-M2",
+        ANTHROPIC_DEFAULT_OPUS_MODEL: "MiniMax-M2",
+        ANTHROPIC_DEFAULT_HAIKU_MODEL: "MiniMax-M2"
+      },
+      includeCoAuthoredBy: false,
+      alwaysThinkingEnabled: true
+    }
+  }
+};
+function getAvailableProviders() {
+  return Object.values(PROVIDER_TEMPLATES);
+}
+function getProviderTemplate(name) {
+  return PROVIDER_TEMPLATES[name.toLowerCase()];
+}
+function applyProviderTemplate(template, apiKey) {
+  const settings = JSON.parse(JSON.stringify(template.settings));
+  settings.env.ANTHROPIC_AUTH_TOKEN = apiKey;
+  return settings;
+}
+
+// src/config.ts
 var CONFIG_DIR = join(homedir(), ".claude-multi");
 var CONFIG_FILE = join(CONFIG_DIR, "config.json");
 function ensureConfigDir() {
@@ -7498,6 +7559,14 @@ async function listMcpServers(instanceName) {
   const mcpConfig = await detectMcpConfigurations(instance.configDir);
   return mcpConfig?.mcpServers || null;
 }
+async function createSettingsFromTemplate(targetConfigDir, template, apiKey) {
+  if (!existsSync(targetConfigDir)) {
+    await mkdir(targetConfigDir, { recursive: true });
+  }
+  const settings = applyProviderTemplate(template, apiKey);
+  const settingsFile = join(targetConfigDir, "settings.json");
+  await writeFile(settingsFile, JSON.stringify(settings, null, 2), "utf-8");
+}
 
 // src/wrapper.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, chmodSync, unlinkSync } from "node:fs";
@@ -7628,8 +7697,8 @@ async function updateClaudeCode() {
 
 // src/cli.ts
 var program2 = new Command;
-program2.name("claude-multi").description("Manage multiple Claude Code instances with different aliases").version("0.1.0");
-program2.command("add <name>").description("Add a new Claude Code instance").option("-c, --config <dir>", "Config directory path", (name) => join2(homedir2(), `.claude-${name}`)).option("-b, --binary <path>", "Binary path (default: ~/.local/bin/claude-<name>)").option("--copy-settings", "Copy settings.json from default Claude").option("--copy-all", "Copy all files from default Claude").option("--copy-mcp", "Copy MCP server configurations from default Claude").option("--skip-prompts", "Skip interactive prompts (start fresh)").action(async (name, options) => {
+program2.name("claude-multi").description("Manage multiple Claude Code instances with different aliases").version("0.3.0");
+program2.command("add <name>").description("Add a new Claude Code instance").option("-c, --config <dir>", "Config directory path", (name) => join2(homedir2(), `.claude-${name}`)).option("-b, --binary <path>", "Binary path (default: ~/.local/bin/claude-<name>)").option("--copy-settings", "Copy settings.json from default Claude").option("--copy-all", "Copy all files from default Claude").option("--copy-mcp", "Copy MCP server configurations from default Claude").option("--skip-prompts", "Skip interactive prompts (start fresh)").option("--provider <name>", "Use a provider template (glm, minimax)").option("--api-key <key>", "API key for the provider").action(async (name, options) => {
   try {
     const configDir = options.config || join2(homedir2(), `.claude-${name}`);
     const binaryPath = options.binary || getDefaultBinaryPath(name);
@@ -7638,7 +7707,23 @@ program2.command("add <name>").description("Add a new Claude Code instance").opt
     let copySettings = false;
     let copyAllFiles = false;
     let copyMcpServers = false;
-    if (options.copySettings || options.copyAll || options.copyMcp || options.skipPrompts) {
+    let useProviderTemplate = false;
+    let providerTemplate = null;
+    let apiKey = "";
+    if (options.provider) {
+      providerTemplate = getProviderTemplate(options.provider);
+      if (!providerTemplate) {
+        console.error(source_default.red(`✗ Unknown provider '${options.provider}'. Available: glm, minimax`));
+        process.exit(1);
+      }
+      if (!options.apiKey) {
+        console.error(source_default.red("✗ --api-key is required when using --provider"));
+        process.exit(1);
+      }
+      apiKey = options.apiKey;
+      useProviderTemplate = true;
+    }
+    if (options.copySettings || options.copyAll || options.copyMcp || options.skipPrompts || options.provider) {
       if (options.copyAll) {
         copyAllFiles = true;
         copySettings = true;
@@ -7711,6 +7796,12 @@ Found existing Claude Code configuration at ~/.claude`));
       await copyAllFromDefault(configDir);
       console.log(source_default.green("✓ Copied all files from default Claude"));
     }
+    if (useProviderTemplate && providerTemplate && !copySettings && !copyAllFiles) {
+      await createSettingsFromTemplate(configDir, providerTemplate, apiKey);
+      console.log(source_default.green(`✓ Applied ${providerTemplate.displayName} template`));
+    } else if (useProviderTemplate && (copySettings || copyAllFiles)) {
+      console.log(source_default.yellow("⚠ Provider template skipped (copied settings from default Claude)"));
+    }
     console.log(source_default.green(`
 ✓ Instance '${name}' created successfully!`));
     console.log(source_default.gray(`  Binary: ${binaryPath}`));
@@ -7939,6 +8030,49 @@ async function handleAddInstance() {
     console.log(source_default.red(`✗ Instance '${name}' already exists`));
     return;
   }
+  const { useProvider } = await import_prompts.default({
+    type: "confirm",
+    name: "useProvider",
+    message: "Would you like to use a provider template (GLM, MiniMax)?",
+    initial: false
+  });
+  let providerTemplate = null;
+  let apiKey = "";
+  if (useProvider) {
+    const providers = getAvailableProviders();
+    const providerChoices = [
+      ...providers.map((p) => ({
+        title: `${p.displayName} - ${p.description}`,
+        value: p.name
+      })),
+      { title: "None / Custom", value: "none" }
+    ];
+    const { selectedProvider } = await import_prompts.default({
+      type: "select",
+      name: "selectedProvider",
+      message: "Select a provider:",
+      choices: providerChoices,
+      initial: 0
+    });
+    if (!selectedProvider || selectedProvider === "none") {} else {
+      providerTemplate = getProviderTemplate(selectedProvider);
+      if (providerTemplate) {
+        const { inputApiKey } = await import_prompts.default({
+          type: "password",
+          name: "inputApiKey",
+          message: `Enter your ${providerTemplate.displayName} API key:`,
+          validate: (value) => {
+            if (!value.trim())
+              return "API key is required";
+            return true;
+          }
+        });
+        if (!inputApiKey)
+          return;
+        apiKey = inputApiKey;
+      }
+    }
+  }
   const { useDefaults } = await import_prompts.default({
     type: "confirm",
     name: "useDefaults",
@@ -8029,6 +8163,12 @@ async function handleAddInstance() {
     await copyAllFromDefault(configDir);
     console.log(source_default.green("✓ Copied all files from default Claude"));
   }
+  if (providerTemplate && !copySettings && !copyAllFiles) {
+    await createSettingsFromTemplate(configDir, providerTemplate, apiKey);
+    console.log(source_default.green(`✓ Applied ${providerTemplate.displayName} template`));
+  } else if (providerTemplate && (copySettings || copyAllFiles)) {
+    console.log(source_default.yellow("⚠ Provider template skipped (copied settings from default Claude)"));
+  }
   console.log(source_default.green(`
 ✓ Instance '${name}' created successfully!`));
   console.log(source_default.gray(`  Binary: ${binaryPath}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-multi",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Manage multiple Claude Code instances with different aliases and configurations",
   "type": "module",
   "bin": {