ai-account-switch 1.5.6 → 1.6.0

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README_ZH.md)
 
-A cross-platform CLI tool to manage and switch between Claude/Codex account configurations for different projects.
+A cross-platform CLI tool to manage and switch between Claude/Codex/Droids account configurations for different projects.
 
 ## Features
 
@@ -13,7 +13,8 @@ A cross-platform CLI tool to manage and switch between Claude/Codex account conf
 - **Claude Code Integration**: Automatically generates `.claude/settings.local.json` for Claude Code CLI
 - **Secure Storage**: Account credentials stored locally in your home directory
 - **Interactive CLI**: Easy-to-use interactive prompts for all operations
-- **Account Types**: Support for Claude, Codex, and other AI services
+- **Account Types**: Support for Claude, Codex, CCR (Claude Code Router), Droids, and other AI services
+- **Web UI**: Modern web interface with account status checking and management
 
 ## Installation
 
@@ -92,7 +93,7 @@ ais add my-claude-account
 ```
 
 You'll be prompted to enter:
-- Account type (Claude, Codex, Other)
+- Account type (Claude, Codex, CCR, Droids, Other)
 - API Key
 - API URL (optional)
 - Organization ID (optional)
@@ -329,6 +330,265 @@ grep -A 10 "$(cat .codex-profile)" ~/.codex/config.toml
 ais doctor
 ```
 
+### CCR (Claude Code Router) Integration
+
+[Claude Code Router](https://github.com/musistudio/claude-code-router) is a powerful routing layer for Claude Code that allows you to use multiple AI providers and models seamlessly.
+
+When you add a **CCR** type account and run `ais use`, the tool automatically:
+1. Updates `~/.claude-code-router/config.json` with Provider and Router configuration
+2. Generates `.claude/settings.local.json` pointing to the local CCR Router
+3. Automatically restarts CCR Router to apply changes
+
+**Prerequisites:**
+- Install Claude Code Router: `npm install -g @musistudio/claude-code-router`
+- Start CCR Router: `ccr start`
+
+#### Adding a CCR Account
+
+When adding a CCR account, you'll see helpful configuration tips:
+
+```bash
+ais add my-ccr-account
+
+? Select account type: CCR
+
+📝 CCR Configuration Tips:
+   • CCR configuration will be stored in ~/.claude-code-router/config.json
+   • You need to provide Provider name and models
+   • Router configuration will be automatically updated
+
+? Enter API Key: sk-xxx...
+? Enter API URL: http://localhost:3000/v1/chat/completions
+? Enter Provider name: Local-new-api
+? Enter default model: gemini-2.5-flash
+? Enter background model: gemini-2.5-flash
+? Enter think model: gemini-2.5-pro
+```
+
+**Important Notes:**
+- Default API URL is `http://localhost:3000/v1/chat/completions`
+- You need to specify three models: default, background, and think
+- Models are automatically deduplicated in the Provider configuration
+
+#### Using CCR with Your Project
+
+After running `ais use` with a CCR account:
+
+```bash
+cd ~/my-project
+ais use my-ccr-account
+
+# Output:
+# ✓ Switched to account 'my-ccr-account' for current project.
+# 🔄 Restarting CCR Router...
+# ✓ CCR Router restarted successfully
+# ✓ CCR configuration updated at: ~/.claude-code-router/config.json
+# ✓ Claude configuration generated at: .claude/settings.local.json
+#
+# 📖 Next Steps:
+#    Start interactive session: claude
+#    This will enter project-level interactive mode
+#    Claude Code will use CCR Router to route requests
+```
+
+The tool:
+1. **Updates CCR Config**: Adds/updates Provider in `~/.claude-code-router/config.json`
+2. **Updates Router**: Sets default, background, and think models
+3. **Generates Claude Config**: Creates `.claude/settings.local.json` with `ANTHROPIC_BASE_URL` pointing to CCR Router
+4. **Restarts CCR**: Automatically runs `ccr restart` to apply changes
+
+#### Running Claude with CCR
+
+Start Claude interactive session:
+
+```bash
+# In your project directory
+claude
+
+# Claude Code will automatically use CCR Router
+# Requests are routed based on your CCR configuration
+```
+
+#### CCR Configuration Structure
+
+The generated configuration in `~/.claude-code-router/config.json`:
+
+```json
+{
+  "PORT": 3456,
+  "Providers": [
+    {
+      "api_base_url": "http://localhost:3000/v1/chat/completions",
+      "api_key": "sk-xxx...",
+      "models": ["gemini-2.5-flash", "gemini-2.5-pro"],
+      "name": "Local-new-api"
+    }
+  ],
+  "Router": {
+    "default": "Local-new-api,gemini-2.5-flash",
+    "background": "Local-new-api,gemini-2.5-flash",
+    "think": "Local-new-api,gemini-2.5-pro"
+  }
+}
+```
+
+The generated configuration in `.claude/settings.local.json`:
+
+```json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
+    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456"
+  }
+}
+```
+
+#### Switching Between Projects
+
+Each project can use a different CCR configuration:
+
+```bash
+# Project A
+cd ~/project-a
+ais use ccr-account-1
+claude
+
+# Project B
+cd ~/project-b
+ais use ccr-account-2
+claude
+```
+
+#### Troubleshooting CCR
+
+**Check CCR Configuration**
+```bash
+# View your CCR configuration
+cat ~/.claude-code-router/config.json
+
+# View Claude configuration
+cat .claude/settings.local.json
+
+# Or use the doctor command
+ais doctor
+```
+
+**CCR Router not installed**
+- Install from npm: `npm install -g @musistudio/claude-code-router`
+- Visit the project page: https://github.com/musistudio/claude-code-router
+
+**CCR Router not restarting**
+- Make sure CCR CLI is installed and available in your PATH
+- Run `ccr restart` manually if automatic restart fails
+- Check if CCR Router is running: `ccr status`
+
+**Claude not using CCR Router**
+- Verify `ANTHROPIC_BASE_URL` in `.claude/settings.local.json` points to correct port
+- Check CCR Router is running on the configured port
+- Restart Claude Code after configuration changes
+
+### Droids Integration
+
+When you add a **Droids** type account and run `ais use`, the tool automatically creates a configuration file at `.droids/config.json` in your project directory.
+
+#### Adding a Droids Account
+
+When adding a Droids account, you'll see helpful configuration tips:
+
+```bash
+ais add my-droids-account
+
+? Select account type: Droids
+
+📝 Droids Configuration Tips:
+   • Droids configuration will be stored in .droids/config.json
+   • API URL is optional (defaults to Droids default endpoint)
+   • You can configure custom models and settings
+
+? Enter API Key: sk-xxx...
+? Enter API URL (optional): https://api.example.com
+? Do you want to specify a model? (Optional) Yes
+? Enter model name: droids-model-v1
+```
+
+#### Using Droids with Your Project
+
+After running `ais use` with a Droids account:
+
+```bash
+cd ~/my-project
+ais use my-droids-account
+
+# Output:
+# ✓ Switched to account 'my-droids-account' for current project.
+# ✓ Droids configuration generated at: .droids/config.json
+#
+# 📖 Next Steps:
+#    Start interactive session: droid
+#    This will enter project-level interactive mode
+#    Droids will automatically use the configuration from .droids/config.json
+```
+
+The tool creates:
+- **Project Configuration**: `.droids/config.json` with your account settings
+
+#### Running Droids
+
+Start Droids interactive session:
+
+```bash
+# In your project directory
+droid
+
+# Droids will automatically load configuration from .droids/config.json
+```
+
+#### Droids Configuration Structure
+
+The generated configuration in `.droids/config.json`:
+
+```json
+{
+  "apiKey": "your-api-key",
+  "baseUrl": "https://api.example.com",
+  "model": "droids-model-v1",
+  "customSettings": {
+    "CUSTOM_VAR": "value"
+  }
+}
+```
+
+#### Switching Between Projects
+
+Each project can use a different Droids account:
+
+```bash
+# Project A
+cd ~/project-a
+ais use droids-account-1
+droid
+
+# Project B
+cd ~/project-b
+ais use droids-account-2
+droid
+```
+
+#### Troubleshooting Droids
+
+**Check Droids Configuration**
+```bash
+# View your Droids configuration
+cat .droids/config.json
+
+# Or use the doctor command
+ais doctor
+```
+
+**Droids CLI not found**
+- Make sure Droids CLI is installed and available in your PATH
+- Run `droid --version` to verify installation
+
 #### Custom Environment Variables
 
 You can add custom environment variables when creating an account. When prompted, enter them in `KEY=VALUE` format:
@@ -370,6 +630,9 @@ ais add work-claude
 # Add a Codex account
 ais add codex-dev
 
+# Add a Droids account
+ais add droids-dev
+
 # List all accounts
 ais list
 ```
@@ -426,8 +689,16 @@ ais paths
 
 ## Requirements
 
-- Node.js >= 14.0.0
-- npm >= 6.0.0
+- **Node.js**: >= 16.0.0
+- **npm**: >= 7.0.0
+
+**Note**: This tool requires Node.js version 16 or higher (due to commander@11.x dependency). You can check your current version with:
+```bash
+node --version
+npm --version
+```
+
+If you need to upgrade Node.js, visit [nodejs.org](https://nodejs.org/) or use a version manager like [nvm](https://github.com/nvm-sh/nvm).
 
 ## Project Structure
 
@@ -517,6 +788,55 @@ MIT License - feel free to use this tool in your projects!
 
 ## Changelog
 
+### v1.6.0
+- **CCR (Claude Code Router) Integration**:
+  - Added full support for Claude Code Router
+  - Automatic generation of `~/.claude-code-router/config.json` configuration
+  - Provider and Router configuration management
+  - Automatic CCR Router restart after configuration changes
+  - Claude Code integration with local CCR Router endpoint
+  - Support for default, background, and think model routing
+- **Web UI Enhancements**:
+  - Added account status checking with color-coded indicators (green: available, orange: unstable, red: unavailable)
+  - Status results are saved and displayed on page load
+  - Real-time status checking with "状态检查" button
+  - Improved account card layout with status in top-right corner
+  - Enhanced visual feedback during status checks
+- **Configuration Improvements**:
+  - CCR accounts automatically generate both CCR and Claude configurations
+  - Dynamic port reading from CCR config for Claude integration
+  - Better error handling and user feedback
+
+### v1.5.8
+- **Bilingual Support (双语支持)**:
+  - All CLI commands now display both English and Chinese text (所有 CLI 命令现在同时显示中英文)
+  - Help messages, prompts, and output messages are bilingual (帮助信息、提示和输出消息都支持双语)
+  - Better user experience for Chinese-speaking users (为中文用户提供更好的使用体验)
+  - No configuration needed - works out of the box (无需配置 - 开箱即用)
+  - Uses parentheses format for better clarity: `English text (中文)` (使用括号格式更清晰)
+
+### v1.5.7
+- **Droids Integration**:
+  - Added full support for Droids AI assistant
+  - Automatic generation of `.droids/config.json` configuration
+  - Simple model configuration for Droids accounts
+  - Interactive session command: `droid`
+  - Enhanced `ais doctor` command with Droids configuration detection
+- **UI Enhancements**:
+  - Added type filter dropdown for quick account filtering
+  - Color-coded account cards by type (Claude: blue, Codex: purple, Droids: green, Other: orange)
+  - Left border color indicators on account cards
+  - Improved visual hierarchy and user experience
+- **Model Configuration Improvements**:
+  - Separated model configuration for different account types
+  - Claude: Complex model groups with multiple model settings
+  - Codex/Droids: Simple model field for straightforward configuration
+  - All model settings moved to collapsible "Advanced Configuration" section
+- **Better User Guidance**:
+  - Enhanced `ais use` command with clear next-step instructions
+  - Type-specific usage examples for each AI assistant
+  - Interactive mode prompts instead of one-time command examples
+
 ### v1.5.1
 - **Codex Integration Enhancements**:
   - Added full support for Codex CLI with profile-based configuration