cckit 0.1.5 → 0.3.0

package/README.md

@@ -1,12 +1,12 @@
 # cckit (Node.js Edition)
 
-Code Kit for Claude Model Switching - Support 智谱LLM, MiniMax, Kimi, Kuaishou StreamLake, ZenMux.ai, and official Claude
+Code Kit for Claude Model Switching - Support 智谱 Coding Plan, MiniMax Coding Plan, Kimi Coding Plan, 快手 StreamLake Coding Plan, 火山引擎 Coding Plan, ZenMux.ai, and official Claude
 
 A CLI tool for managing and switching between different Claude model providers and their configurations. Features support for model gateways like ZenMux.ai and Kuaishou StreamLake that provide unified access to multiple AI providers.
 
 ## Features
 
-- **Multiple Provider Support**: Configure and switch between 智谱LLM, MiniMax, Kimi, Kuaishou StreamLake, ZenMux.ai, and official Claude
+- **Multiple Provider Support**: Configure and switch between 智谱 Coding Plan, MiniMax Coding Plan, Kimi Coding Plan, 快手 StreamLake Coding Plan, 火山引擎 Coding Plan, 阿里云 Coding Plan, 腾讯云 Coding Plan, 讯飞 Coding Plan, ZenMux.ai, official Claude, and custom providers
 - **Easy Configuration**: Simple command-line interface for managing API keys and settings
 - **Claude Integration**: Automatically updates Claude Code configuration files
 - **Export/Import**: Backup and restore your provider configurations
@@ -26,6 +26,129 @@ pnpm add -g cckit
 yarn global add cckit
 ```
 
+## Quick Start (Interactive Mode)
+
+```bash
+# Start interactive configuration wizard (recommended for first-time users)
+cckit interactive
+```
+
+## Interactive Mode Details
+
+The interactive wizard (`cckit interactive`) provides a user-friendly, step-by-step configuration experience with arrow key selection:
+
+### Step-by-Step Guide
+
+```
+▸ Step 1: 选择要配置的 AI 提供商
+```
+Use ↑/↓ arrow keys to select from:
+- **Preset Providers**: 智谱 Coding Plan, MiniMax Coding Plan, Kimi Coding Plan, ZenMux, 快手 StreamLake Coding Plan, 火山引擎 Coding Plan, 阿里云 Coding Plan, 腾讯云 Coding Plan, 讯飞 Coding Plan, Claude
+- **Custom Provider**: For local LLMs (Ollama, LocalAI, LM Studio) or any OpenAI-compatible API
+
+```
+▸ Step 2: 配置 [Provider Name]
+```
+- Enter your API key (required)
+- For custom providers: Enter the base URL (e.g., `http://localhost:11434/v1`)
+
+```
+▸ Step 3: 设置模型
+```
+- Enter the model name (default value provided based on provider)
+
+```
+▸ Step 4: 保存配置
+```
+- If existing configurations found, choose to update or create new
+- Configuration saved to `~/.cckit/config.json`
+
+```
+▸ Step 5: 测试连接
+```
+- Optional: Test the connection to verify API key and endpoint
+
+```
+▸ Step 6: 切换 Provider
+```
+- Optional: Switch to the newly configured provider immediately
+
+### Features
+
+- **Arrow Key Navigation**: Easy selection with keyboard
+- **Smart Defaults**: Pre-filled model names based on provider
+- **Existing Config Detection**: Detects and offers to update existing configurations
+- **Connection Testing**: Verify setup before switching
+- **Immediate Switch**: Option to activate the provider right away
+
+### Example Session
+
+```bash
+$ cckit interactive
+
+    ___      ___     / ___     ( ) __  ___
+   //   ) ) //   ) ) //\ \     / /   / /
+  //       //       //  \ \   / /   / /
+ ((____   ((____   //    \ \ / /   / /
+              交互式配置向导
+
+▸ Step 1: 选择要配置的 AI 提供商
+
+? 请选择提供商: (Use arrow keys)
+❯ 智谱 Coding Plan (GLM)
+  MiniMax Coding Plan
+  Kimi Coding Plan
+  ZenMux.ai
+  快手 StreamLake Coding Plan
+  火山引擎 Coding Plan
+  阿里云 Coding Plan
+  腾讯云 Coding Plan
+  讯飞 Coding Plan
+  Claude (Official)
+  自定义 Provider (Local LLM / OpenAI Compatible)
+
+▸ Step 2: 配置 智谱 Coding Plan
+
+? 请输入 API Key: [your-api-key]
+
+▸ Step 3: 设置模型
+
+? 请输入模型名称: (GLM-4.7)
+
+▸ Step 4: 保存配置
+
+✓ 配置已保存 (id: zhipu_xxx)
+  Provider: 智谱 Coding Plan
+  Model: GLM-4.7
+
+▸ Step 5: 测试连接
+
+? 是否测试连接? (Y/n)
+
+✓ 连接成功!
+  响应时间: 234ms
+
+▸ Step 6: 切换 Provider
+
+? 是否立即切换到该 Provider? (Y/n)
+
+✓ 已切换到 智谱 Coding Plan
+  请重启终端或新开会话以使配置生效
+
+    ___      ___     / ___     ( ) __  ___
+   //   ) ) //   ) ) //\ \     / /   / /
+  //       //       //  \ \   / /   / /
+ ((____   ((____   //    \ \ / /   / /
+              配置完成! ✓
+```
+
+The interactive wizard will guide you through:
+1. Selecting an AI provider (智谱 Coding Plan, MiniMax Coding Plan, Kimi Coding Plan, Claude, ZenMux, 快手 StreamLake Coding Plan, 火山引擎 Coding Plan, 阿里云 Coding Plan, 腾讯云 Coding Plan, 讯飞 Coding Plan, or Custom)
+2. Entering your API key
+3. Setting up the model name
+4. Testing the connection
+5. Switching to the configured provider
+
 ## Usage
 
 ### Basic Commands
@@ -43,6 +166,9 @@ cckit current
 # Configure a provider
 cckit configure <provider> --api-key <key> [--base-url <url>] [--model <model>] ...
 
+# Configure a custom provider (local LLM, OpenAI-compatible API, etc.)
+cckit configure my-ollama --api-key "ollama-key" --base-url "http://localhost:11434/v1" --model "llama3"
+
 # Switch to a provider
 cckit switch <provider>
 
@@ -64,9 +190,9 @@ cckit remove-model <provider> <model>
 
 ### Supported Providers
 
-#### 智谱LLM (Zhipu) - [https://www.bigmodel.cn/claude-code?ic=AFDPNDPWIF](https://www.bigmodel.cn/claude-code?ic=AFDPNDPWIF)
+#### 智谱 Coding Plan - [https://www.bigmodel.cn/claude-code?ic=AFDPNDPWIF](https://www.bigmodel.cn/claude-code?ic=AFDPNDPWIF)
 ```bash
-# Configure 智谱LLM with a single model
+# Configure 智谱 Coding Plan with a single model
 cckit configure zhipu --api-key "your-api-key" --model "GLM-4.7"
 
 # Configure with multiple models
@@ -81,13 +207,13 @@ cckit set-model zhipu "GLM-4-Plus"
 # Remove a model
 cckit remove-model zhipu "GLM-4.7"
 
-# Switch to 智谱LLM
+# Switch to 智谱 Coding Plan
 cckit switch zhipu
 ```
 
-#### MiniMax - [https://platform.minimaxi.com/subscribe/coding-plan](https://platform.minimaxi.com/subscribe/coding-plan?code=3FiunKqPhD&source=link)
+#### MiniMax Coding Plan - [https://platform.minimaxi.com/subscribe/coding-plan](https://platform.minimaxi.com/subscribe/coding-plan?code=3FiunKqPhD&source=link)
 ```bash
-# Configure MiniMax with multiple models
+# Configure MiniMax Coding Plan with multiple models
 cckit configure minimax --api-key "your-api-key" --model "MiniMax-M2" --model "MiniMax-M4"
 
 # List models
@@ -99,13 +225,13 @@ cckit set-model minimax "MiniMax-M4"
 # Remove a model
 cckit remove-model minimax "MiniMax-M2"
 
-# Switch to MiniMax
+# Switch to MiniMax Coding Plan
 cckit switch minimax
 ```
 
-#### Kimi (Moonshot) - [https://www.kimi.com/coding/docs/](https://www.kimi.com/coding/docs/)
+#### Kimi Coding Plan - [https://www.kimi.com/coding/docs/](https://www.kimi.com/coding/docs/)
 ```bash
-# Configure Kimi with multiple models
+# Configure Kimi Coding Plan with multiple models
 cckit configure kimi --api-key "your-api-key" --model "kimi-for-coding" --model "kimi-plus"
 
 # List models
@@ -114,7 +240,7 @@ cckit models kimi
 # Set active model
 cckit set-model kimi "kimi-plus"
 
-# Switch to Kimi
+# Switch to Kimi Coding Plan
 cckit switch kimi
 ```
 
@@ -148,9 +274,9 @@ cckit set-model claude "claude-3-opus-20250219"
 cckit switch claude
 ```
 
-#### Kuaishou StreamLake - [快手万擎引擎](https://wanqing.streamlakeapi.com)
+#### 快手 StreamLake Coding Plan - [快手万擎引擎](https://streamlake.com/marketing/coding-plan)
 ```bash
-# Configure Kuaishou StreamLake with multiple models
+# Configure 快手 StreamLake Coding Plan with multiple models
 cckit configure streamlake --api-key "your-streamlake-api-key" --model "kat-coder-pro-v1" --model "claude-3-opus-20250219"
 
 # List models
@@ -159,10 +285,102 @@ cckit models streamlake
 # Set active model
 cckit set-model streamlake "claude-3-opus-20250219"
 
-# Switch to Kuaishou StreamLake
+# Switch to 快手 StreamLake Coding Plan
 cckit switch streamlake
 ```
 
+#### 火山引擎 Coding Plan [火山方舟](https://www.volcengine.com/activity/codingplan)
+```bash
+# Configure 火山引擎 Coding Plan with multiple models
+cckit configure volcengine --api-key "your-ark-api-key" --model "ark-code-latest" --model "ark-code-pro"
+
+# List models
+cckit models volcengine
+
+# Set active model
+cckit set-model volcengine "ark-code-pro"
+
+# Switch to 火山引擎 Coding Plan
+cckit switch volcengine
+```
+
+#### Aliyun [阿里云 Coding Plan https://www.aliyun.com/benefit/scene/codingplan](https://www.aliyun.com/benefit/ai/aistar?clubBiz=subTask..12414135..10263..)
+```bash
+# Configure Aliyun Coding Plan with multiple models
+cckit configure aliyun --api-key "your-api-key" --model "qwen3.5-plus" --model "kimi-k2.5" --model "glm-5" --model "MiniMax-M2.5"
+
+# List models
+cckit models aliyun
+
+# Set active model
+cckit set-model aliyun "glm-5"
+
+# Switch to Aliyun
+cckit switch aliyun
+```
+
+#### Tencent [腾讯云 Coding Plan]
+```bash
+# Configure Tencent Coding Plan with multiple models
+cckit configure tencent --api-key "your-api-key" --model "GLM-5" --model "MiniMax-M2.5" --model "Kimi-K2.5"
+
+# List models
+cckit models tencent
+
+# Set active model
+cckit set-model tencent "MiniMax-M2.5"
+
+# Switch to Tencent
+cckit switch tencent
+```
+
+#### XFYun [讯飞 Coding Plan]
+```bash
+# Configure XFYun Coding Plan with multiple models
+cckit configure xfyun --api-key "your-api-key" --model "GLM-5" --model "MiniMax-M2.5" --model "Kimi-K2.5"
+
+# List models
+cckit models xfyun
+
+# Set active model
+cckit set-model xfyun "MiniMax-M2.5"
+
+# Switch to XFYun
+cckit switch xfyun
+```
+
+#### Custom Provider - Local/OpaqueAI/OpenAI Compatible APIs
+
+Configure custom providers for local LLMs (Ollama, LocalAI, LM Studio), opaque API endpoints, or any Anthropic-compatible API:
+
+```bash
+# Configure a local Ollama instance
+cckit configure ollama --api-key "ollama-key" --base-url "http://localhost:11434/v1" --model "llama3"
+
+# Configure using the 'custom:' prefix (explicit custom provider)
+cckit configure custom:my-ollama --api-key "ollama-key" --base-url "http://localhost:11434/v1" --model "llama3"
+
+# Configure for OpenAI compatible API (e.g., via proxy)
+cckit configure openwebui --api-key "your-token" --base-url "http://localhost:8080/v1" --model "anthropic/claude-3-haiku"
+
+# List models
+cckit models ollama
+
+# Set active model
+cckit set-model ollama "llama3"
+
+# Switch to custom provider
+cckit switch ollama
+```
+
+Custom providers support:
+- Local LLM servers (Ollama, LocalAI, LM Studio, llama.cpp)
+- OpenAI-compatible API endpoints
+- Any Anthropic-compatible gateway or proxy
+- Opaque/enterprise API endpoints
+
+The custom provider uses `provider_name` as the `CC_PROVIDER` environment variable value, allowing you to distinguish between multiple custom providers.
+
 ### Advanced Commands
 
 ```bash
@@ -174,6 +392,9 @@ cckit import backup.json
 
 # Reset to default Claude configuration
 cckit reset
+
+# Interactive configuration wizard (new!)
+cckit interactive
 ```
 
 ## Configuration
@@ -194,12 +415,17 @@ The active model is used when Claude Code switches to that provider. If no expli
 
 | Provider | Default Model | Auth Method | Capabilities | Default Base URL |
 |----------|---------------|-------------|--------------|------------------|
-| 智谱LLM | GLM-4.7 | ANTHROPIC_AUTH_TOKEN | Chat, Code Generation, Chinese Support | https://open.bigmodel.cn/api/anthropic |
-| MiniMax | MiniMax-M2 | ANTHROPIC_AUTH_TOKEN | Chat, Code Generation, Multi-language | https://api.minimaxi.com/anthropic |
-| Kimi | kimi-for-coding | ANTHROPIC_API_KEY | Chat, Long Context, Code Generation | https://api.kimi.com/coding/ |
+| 智谱 Coding Plan | GLM-4.7 | ANTHROPIC_AUTH_TOKEN | Chat, Code Generation, Chinese Support | https://open.bigmodel.cn/api/anthropic |
+| MiniMax Coding Plan | MiniMax-M2 | ANTHROPIC_AUTH_TOKEN | Chat, Code Generation, Multi-language | https://api.minimaxi.com/anthropic |
+| Kimi Coding Plan | kimi-for-coding | ANTHROPIC_API_KEY | Chat, Long Context, Code Generation | https://api.kimi.com/coding/ |
 | ZenMux.ai | claude-3-5-sonnet-20241022 | ANTHROPIC_API_KEY | Model Gateway, Multi-provider, Claude Compatible | https://zenmux.ai/api/anthropic |
-| Kuaishou StreamLake | kat-coder-pro-v1 | ANTHROPIC_API_KEY | Chat, Code Generation, Chinese Support, Video Understanding | https://wanqing.streamlakeapi.com/api/gateway/v1/endpoints/kat-coder-pro-v1/claude-code-proxy |
+| 快手 StreamLake Coding Plan | kat-coder-pro-v1 | ANTHROPIC_API_KEY | Chat, Code Generation, Chinese Support, Video Understanding | https://wanqing.streamlakeapi.com/api/gateway/v1/endpoints/kat-coder-pro-v1/claude-code-proxy |
+| 火山引擎 Coding Plan | ark-code-latest | ANTHROPIC_AUTH_TOKEN | Chat, Code Generation, Chinese Support | https://ark.cn-beijing.volces.com/api/coding |
+| 阿里云 Coding Plan | claude-sonnet-4-20250514 | ANTHROPIC_AUTH_TOKEN | Chat, Code Generation, Chinese Support, Multimodal | https://coding.dashscope.aliyuncs.com/apps/anthropic |
+| 腾讯云 Coding Plan | GLM-5 | ANTHROPIC_AUTH_TOKEN | Chat, Code Generation, Chinese Support, Multimodal | https://api.lkeap.cloud.tencent.com/coding/anthropic |
+| 讯飞 Coding Plan | GLM-5 | ANTHROPIC_AUTH_TOKEN | Chat, Code Generation, Chinese Support, Multimodal | https://maas-coding-api.cn-huabei-1.xf-yun.com/anthropic |
 | Claude | claude-3-5-sonnet-20241022 | ANTHROPIC_API_KEY | Chat, Code Generation, Analysis, Multimodal | Official |
+| Custom | - | ANTHROPIC_API_KEY | Custom, User-defined, Local LLM, Anthropic Compatible API | User-defined |
 
 ## How It Works
 
@@ -231,28 +457,11 @@ For more build options and details, see [BUILD.md](BUILD.md).
 
 ## Requirements
 
-- Node.js 18 or higher
+- Node.js 20 or higher
 - pnpm (or npm/yarn)
 - Claude Code installed
 - Valid API keys for the providers you want to use
 
-## Project Structure
-
-```
-cckit-node/
-├── src/
-│   ├── index.ts          # Main CLI entry point
-│   ├── types.ts          # TypeScript type definitions
-│   ├── config.ts         # Configuration management
-│   ├── commands.ts       # CLI command implementations
-│   ├── providers.ts      # Provider configurations and testing
-│   └── i18n.ts          # Internationalization (English & Chinese)
-├── dist/                 # Compiled JavaScript output
-├── package.json          # Project dependencies and scripts
-├── tsconfig.json         # TypeScript configuration
-└── README.md            # This file
-```
-
 ## License
 
 This project is licensed under the MIT License - see the LICENSE file for details.

package/dist/commands.d.ts

@@ -2,6 +2,10 @@ import { ConfigManager } from './config.js';
 export declare class Commands {
     private configManager;
     constructor(configManager: ConfigManager);
+    /**
+     * Interactive configuration wizard with arrow key selection
+     */
+    interactive(): Promise<void>;
     list(): void;
     switch(providerId: string): void;
     current(): void;

package/dist/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAsD,MAAM,aAAa,CAAC;AAKhG,qBAAa,QAAQ;IACP,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAEhD,IAAI,IAAI,IAAI;IAgCZ,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAmBhC,OAAO,IAAI,IAAI;IA8Bf,SAAS,CACP,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,IAAI;IA0DP,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAuCxB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B7C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IA6B1B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuEpE,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IA2CxD,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAkB7B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa1B,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,sBAAsB;YAoBhB,YAAY;CAgB3B"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAsD,MAAM,aAAa,CAAC;AAahG,qBAAa,QAAQ;IACP,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAEhD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAmOlC,IAAI,IAAI,IAAI;IAsCZ,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAmBhC,OAAO,IAAI,IAAI;IAkCf,SAAS,CACP,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,IAAI;IAuEP,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IA6CxB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B7C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IA6B1B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuFpE,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IA2CxD,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAkB7B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa1B,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,sBAAsB;YAoChB,YAAY;CAM3B"}