claude-flow-novice 2.14.37 → 2.15.1

package/claude-assets/commands/switch-api.md

@@ -1,53 +1,88 @@
 ---
-description: Switch Main Chat and Task tool between Z.ai and Anthropic providers
+description: Switch Main Chat and Task tool between Z.ai, Kimi, OpenRouter, and Anthropic providers
 tags: [config, api, cost-optimization]
 ---
 
-Switch Main Chat and Task() tool API provider between Z.ai (cost-optimized) and Anthropic (high-quality).
+Switch Main Chat and Task() tool API provider between multiple AI providers.
 
-**Important:** CLI agents always use Z.ai (from `.env`). This command only affects Main Chat and Task() spawned agents.
+**Important:** CLI agents support custom routing when enabled. This command affects Main Chat and Task() spawned agents.
 
 **Usage:**
 - `/switch-api` - Show current status
-- `/switch-api zai` - Main Chat/Task tool use Z.ai ($0.50/1M tokens)
-- `/switch-api max` - Main Chat/Task tool use Anthropic ($15/1M tokens, requires re-login)
+- `/switch-api [zai|kimi|openrouter|max]` - Switch provider
+  - `zai` - Z.ai ($0.50/1M tokens)
+  - `kimi` - Moonshot Kimi ($2/1M tokens)
+  - `openrouter` - OpenRouter (varies by model)
+  - `max` or `claude` - Anthropic ($15/1M tokens, requires re-login)
 
 **Arguments:**
 - `status` - Show current routing configuration (default)
 - `zai` - Route Main Chat + Task tool to Z.ai for cost savings
+- `kimi` - Route Main Chat + Task tool to Moonshot Kimi
+- `openrouter` - Route Main Chat + Task tool to OpenRouter
 - `max` or `claude` - Route Main Chat + Task tool to Anthropic for quality
 
 **What This Does:**
 
 `/switch-api zai`:
-- Adds env vars to `.claude/settings.json`
+- Adds Z.ai env vars to `.claude/settings.local.json` (or settings.json)
 - Main Chat + Task() agents use Z.ai
 - Cost: $0.50/1M tokens (97% savings)
 - No login required
 
+`/switch-api kimi`:
+- Adds Kimi env vars to `.claude/settings.local.json` (or settings.json)
+- Main Chat + Task() agents use Moonshot Kimi
+- Cost: ~$2/1M tokens
+- Requires `KIMI_API_KEY` in root `.env`
+
+`/switch-api openrouter`:
+- Adds OpenRouter env vars to `.claude/settings.local.json` (or settings.json)
+- Main Chat + Task() agents use OpenRouter
+- Cost: Varies by model
+- Requires `OPENROUTER_API_KEY` in root `.env`
+
 `/switch-api max`:
-- Removes env vars from `.claude/settings.json`
+- Removes env vars from `.claude/settings.local.json` (or settings.json)
 - Main Chat + Task() agents use Anthropic
 - Cost: $15/1M tokens (or $0 with unlimited plan)
 - **Requires** running `claude login`
 
+**Note:** Script automatically detects and uses `.claude/settings.local.json` if it exists, otherwise uses `.claude/settings.json`.
+
 **Combined Architecture:**
 ```
-Main Chat (Anthropic or Z.ai - your choice)
+Main Chat (Anthropic/Z.ai/Kimi/OpenRouter - your choice)
   ↓
 Task() → Coordinator (uses Main Chat provider)
   ↓
-CLI spawn → Workers (always Z.ai from .env)
+CLI spawn → Workers (custom routing when enabled, see agent profiles)
 ```
 
 **Execute:**
 ```bash
-bash scripts/switch-api.sh {{args}}
+# Find project root (traverse up looking for scripts/switch-api.sh)
+SCRIPT_DIR="$PWD"
+while [ "$SCRIPT_DIR" != "/" ]; do
+    if [ -f "$SCRIPT_DIR/scripts/switch-api.sh" ]; then
+        break
+    fi
+    SCRIPT_DIR="$(dirname "$SCRIPT_DIR")"
+done
+if [ ! -f "$SCRIPT_DIR/scripts/switch-api.sh" ]; then
+    echo "Error: switch-api.sh not found. Please ensure you're in a project with CFN installed."
+    exit 1
+fi
+bash "$SCRIPT_DIR/scripts/switch-api.sh" {{args}}
 ```
 
+**Note:** Script automatically detects and uses `.claude/settings.local.json` if it exists, otherwise uses `.claude/settings.json`.
+
 **Examples:**
 ```bash
-/switch-api          # Show current routing
-/switch-api zai      # Cost-optimize Main Chat
-/switch-api max      # Quality-optimize Main Chat (requires re-login)
+/switch-api             # Show current routing
+/switch-api zai         # Cost-optimize with Z.ai
+/switch-api kimi        # Use Moonshot Kimi
+/switch-api openrouter  # Use OpenRouter (access 400+ models)
+/switch-api max         # Quality-optimize with Anthropic (requires re-login)
 ```