claude-flow-novice 2.5.2 → 2.6.0

package/dist/cli/iteration-history.js

@@ -0,0 +1,188 @@
+/**
+ * Iteration History Management
+ *
+ * Loads and formats iteration history from Redis for CLI-spawned agents.
+ * Enables agents to learn from previous attempts and feedback.
+ *
+ * Storage Pattern:
+ *   swarm:${TASK_ID}:${AGENT_ID}:result:iteration-${N} → Result text + confidence
+ *   swarm:${TASK_ID}:${AGENT_ID}:feedback:iteration-${N} → Validator feedback
+ *
+ * Sprint 3 - Phase 2 Implementation
+ */ import { execSync } from 'child_process';
+/**
+ * Load iteration history for an agent from Redis
+ *
+ * @param taskId - Task identifier
+ * @param agentId - Agent identifier
+ * @param currentIteration - Current iteration number (loads 1 to N-1)
+ * @returns Array of iteration results
+ */ export async function loadIterationHistory(taskId, agentId, currentIteration) {
+    const history = [];
+    // Load previous iterations (1 to currentIteration - 1)
+    for(let i = 1; i < currentIteration; i++){
+        try {
+            // Load result data
+            const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${i}`;
+            const resultJson = execSync(`redis-cli get "${resultKey}"`, {
+                encoding: 'utf8'
+            }).trim();
+            if (resultJson === '(nil)' || !resultJson) {
+                continue;
+            }
+            const resultData = JSON.parse(resultJson);
+            // Load feedback data (may not exist for all iterations)
+            const feedbackKey = `swarm:${taskId}:${agentId}:feedback:iteration-${i}`;
+            let feedback;
+            try {
+                const feedbackJson = execSync(`redis-cli get "${feedbackKey}"`, {
+                    encoding: 'utf8'
+                }).trim();
+                if (feedbackJson !== '(nil)' && feedbackJson) {
+                    const feedbackData = JSON.parse(feedbackJson);
+                    feedback = feedbackData.feedback || feedbackData.comments;
+                }
+            } catch (err) {
+                // Feedback may not exist for this iteration
+                feedback = undefined;
+            }
+            history.push({
+                iteration: i,
+                result: resultData.result || resultData.output || '',
+                confidence: resultData.confidence || 0,
+                timestamp: resultData.timestamp || new Date().toISOString(),
+                feedback
+            });
+        } catch (err) {
+            console.error(`[iteration-history] Failed to load iteration ${i}:`, err);
+        // Continue loading other iterations
+        }
+    }
+    return history;
+}
+/**
+ * Store iteration result in Redis
+ *
+ * @param taskId - Task identifier
+ * @param agentId - Agent identifier
+ * @param iteration - Iteration number
+ * @param result - Result text/output
+ * @param confidence - Confidence score (0.0-1.0)
+ */ export async function storeIterationResult(taskId, agentId, iteration, result, confidence) {
+    const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${iteration}`;
+    const resultData = {
+        result,
+        confidence,
+        timestamp: new Date().toISOString(),
+        iteration
+    };
+    const resultJson = JSON.stringify(resultData);
+    try {
+        // Store with 24 hour TTL
+        execSync(`redis-cli setex "${resultKey}" 86400 '${resultJson.replace(/'/g, "'\\''")}'`, {
+            encoding: 'utf8'
+        });
+        console.log(`[iteration-history] Stored result for iteration ${iteration}`);
+    } catch (err) {
+        console.error(`[iteration-history] Failed to store result:`, err);
+        throw err;
+    }
+}
+/**
+ * Format iteration history as markdown for system prompt
+ *
+ * @param history - Array of iteration results
+ * @param currentIteration - Current iteration number
+ * @returns Formatted markdown string
+ */ export function formatIterationHistory(history, currentIteration) {
+    if (history.length === 0) {
+        return `## Current Iteration: ${currentIteration}
+
+This is your first attempt at this task. No previous iteration history available.
+`;
+    }
+    const sections = [];
+    sections.push('## Iteration History');
+    sections.push('');
+    sections.push('Learn from your previous attempts and feedback:');
+    sections.push('');
+    // Format each iteration
+    for (const iter of history){
+        sections.push(`### Iteration ${iter.iteration}`);
+        sections.push('');
+        sections.push('**Result:**');
+        sections.push(iter.result.substring(0, 500)); // Truncate to 500 chars
+        if (iter.result.length > 500) {
+            sections.push('... (truncated)');
+        }
+        sections.push('');
+        if (iter.feedback) {
+            sections.push('**Feedback from Validators:**');
+            sections.push(iter.feedback);
+            sections.push('');
+        }
+        sections.push(`**Confidence:** ${iter.confidence.toFixed(2)}`);
+        sections.push(`**Timestamp:** ${iter.timestamp}`);
+        sections.push('');
+        sections.push('---');
+        sections.push('');
+    }
+    // Add current iteration context
+    sections.push(`## Current Iteration: ${currentIteration}`);
+    sections.push('');
+    if (history.length > 0) {
+        const lastIteration = history[history.length - 1];
+        if (lastIteration.feedback) {
+            sections.push('**Your Task:** Address the feedback from the previous iteration:');
+            sections.push('');
+            sections.push(lastIteration.feedback);
+            sections.push('');
+        } else {
+            sections.push(`**Your Task:** Improve upon iteration ${lastIteration.iteration} (confidence: ${lastIteration.confidence.toFixed(2)})`);
+            sections.push('');
+        }
+    }
+    return sections.join('\n');
+}
+/**
+ * Check if iteration history exists for an agent
+ *
+ * @param taskId - Task identifier
+ * @param agentId - Agent identifier
+ * @returns True if any iteration history exists
+ */ export async function hasIterationHistory(taskId, agentId) {
+    try {
+        const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;
+        const keys = execSync(`redis-cli --scan --pattern "${pattern}"`, {
+            encoding: 'utf8'
+        }).trim();
+        return keys.length > 0;
+    } catch (err) {
+        return false;
+    }
+}
+/**
+ * Get the latest iteration number for an agent
+ *
+ * @param taskId - Task identifier
+ * @param agentId - Agent identifier
+ * @returns Latest iteration number (0 if no history)
+ */ export async function getLatestIteration(taskId, agentId) {
+    try {
+        const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;
+        const keys = execSync(`redis-cli --scan --pattern "${pattern}"`, {
+            encoding: 'utf8'
+        }).trim().split('\n').filter((k)=>k.length > 0);
+        if (keys.length === 0) return 0;
+        // Extract iteration numbers and find max
+        const iterations = keys.map((key)=>{
+            const match = key.match(/iteration-(\d+)$/);
+            return match ? parseInt(match[1], 10) : 0;
+        });
+        return Math.max(...iterations);
+    } catch (err) {
+        return 0;
+    }
+}
+
+//# sourceMappingURL=iteration-history.js.map

package/dist/cli/iteration-history.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/iteration-history.ts"],"sourcesContent":["/**\r\n * Iteration History Management\r\n *\r\n * Loads and formats iteration history from Redis for CLI-spawned agents.\r\n * Enables agents to learn from previous attempts and feedback.\r\n *\r\n * Storage Pattern:\r\n *   swarm:${TASK_ID}:${AGENT_ID}:result:iteration-${N} → Result text + confidence\r\n *   swarm:${TASK_ID}:${AGENT_ID}:feedback:iteration-${N} → Validator feedback\r\n *\r\n * Sprint 3 - Phase 2 Implementation\r\n */\r\n\r\nimport { execSync } from 'child_process';\r\n\r\nexport interface IterationResult {\r\n  iteration: number;\r\n  result: string;\r\n  confidence: number;\r\n  timestamp: string;\r\n  feedback?: string;\r\n}\r\n\r\n/**\r\n * Load iteration history for an agent from Redis\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @param currentIteration - Current iteration number (loads 1 to N-1)\r\n * @returns Array of iteration results\r\n */\r\nexport async function loadIterationHistory(\r\n  taskId: string,\r\n  agentId: string,\r\n  currentIteration: number\r\n): Promise<IterationResult[]> {\r\n  const history: IterationResult[] = [];\r\n\r\n  // Load previous iterations (1 to currentIteration - 1)\r\n  for (let i = 1; i < currentIteration; i++) {\r\n    try {\r\n      // Load result data\r\n      const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${i}`;\r\n      const resultJson = execSync(`redis-cli get \"${resultKey}\"`, { encoding: 'utf8' }).trim();\r\n\r\n      if (resultJson === '(nil)' || !resultJson) {\r\n        // No result for this iteration (shouldn't happen in normal flow)\r\n        continue;\r\n      }\r\n\r\n      const resultData = JSON.parse(resultJson);\r\n\r\n      // Load feedback data (may not exist for all iterations)\r\n      const feedbackKey = `swarm:${taskId}:${agentId}:feedback:iteration-${i}`;\r\n      let feedback: string | undefined;\r\n\r\n      try {\r\n        const feedbackJson = execSync(`redis-cli get \"${feedbackKey}\"`, { encoding: 'utf8' }).trim();\r\n        if (feedbackJson !== '(nil)' && feedbackJson) {\r\n          const feedbackData = JSON.parse(feedbackJson);\r\n          feedback = feedbackData.feedback || feedbackData.comments;\r\n        }\r\n      } catch (err) {\r\n        // Feedback may not exist for this iteration\r\n        feedback = undefined;\r\n      }\r\n\r\n      history.push({\r\n        iteration: i,\r\n        result: resultData.result || resultData.output || '',\r\n        confidence: resultData.confidence || 0,\r\n        timestamp: resultData.timestamp || new Date().toISOString(),\r\n        feedback\r\n      });\r\n    } catch (err) {\r\n      console.error(`[iteration-history] Failed to load iteration ${i}:`, err);\r\n      // Continue loading other iterations\r\n    }\r\n  }\r\n\r\n  return history;\r\n}\r\n\r\n/**\r\n * Store iteration result in Redis\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @param iteration - Iteration number\r\n * @param result - Result text/output\r\n * @param confidence - Confidence score (0.0-1.0)\r\n */\r\nexport async function storeIterationResult(\r\n  taskId: string,\r\n  agentId: string,\r\n  iteration: number,\r\n  result: string,\r\n  confidence: number\r\n): Promise<void> {\r\n  const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${iteration}`;\r\n  const resultData = {\r\n    result,\r\n    confidence,\r\n    timestamp: new Date().toISOString(),\r\n    iteration\r\n  };\r\n\r\n  const resultJson = JSON.stringify(resultData);\r\n\r\n  try {\r\n    // Store with 24 hour TTL\r\n    execSync(`redis-cli setex \"${resultKey}\" 86400 '${resultJson.replace(/'/g, \"'\\\\''\")}'`, {\r\n      encoding: 'utf8'\r\n    });\r\n    console.log(`[iteration-history] Stored result for iteration ${iteration}`);\r\n  } catch (err) {\r\n    console.error(`[iteration-history] Failed to store result:`, err);\r\n    throw err;\r\n  }\r\n}\r\n\r\n/**\r\n * Format iteration history as markdown for system prompt\r\n *\r\n * @param history - Array of iteration results\r\n * @param currentIteration - Current iteration number\r\n * @returns Formatted markdown string\r\n */\r\nexport function formatIterationHistory(\r\n  history: IterationResult[],\r\n  currentIteration: number\r\n): string {\r\n  if (history.length === 0) {\r\n    return `## Current Iteration: ${currentIteration}\r\n\r\nThis is your first attempt at this task. No previous iteration history available.\r\n`;\r\n  }\r\n\r\n  const sections: string[] = [];\r\n\r\n  sections.push('## Iteration History');\r\n  sections.push('');\r\n  sections.push('Learn from your previous attempts and feedback:');\r\n  sections.push('');\r\n\r\n  // Format each iteration\r\n  for (const iter of history) {\r\n    sections.push(`### Iteration ${iter.iteration}`);\r\n    sections.push('');\r\n\r\n    sections.push('**Result:**');\r\n    sections.push(iter.result.substring(0, 500)); // Truncate to 500 chars\r\n    if (iter.result.length > 500) {\r\n      sections.push('... (truncated)');\r\n    }\r\n    sections.push('');\r\n\r\n    if (iter.feedback) {\r\n      sections.push('**Feedback from Validators:**');\r\n      sections.push(iter.feedback);\r\n      sections.push('');\r\n    }\r\n\r\n    sections.push(`**Confidence:** ${iter.confidence.toFixed(2)}`);\r\n    sections.push(`**Timestamp:** ${iter.timestamp}`);\r\n    sections.push('');\r\n    sections.push('---');\r\n    sections.push('');\r\n  }\r\n\r\n  // Add current iteration context\r\n  sections.push(`## Current Iteration: ${currentIteration}`);\r\n  sections.push('');\r\n\r\n  if (history.length > 0) {\r\n    const lastIteration = history[history.length - 1];\r\n    if (lastIteration.feedback) {\r\n      sections.push('**Your Task:** Address the feedback from the previous iteration:');\r\n      sections.push('');\r\n      sections.push(lastIteration.feedback);\r\n      sections.push('');\r\n    } else {\r\n      sections.push(`**Your Task:** Improve upon iteration ${lastIteration.iteration} (confidence: ${lastIteration.confidence.toFixed(2)})`);\r\n      sections.push('');\r\n    }\r\n  }\r\n\r\n  return sections.join('\\n');\r\n}\r\n\r\n/**\r\n * Check if iteration history exists for an agent\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @returns True if any iteration history exists\r\n */\r\nexport async function hasIterationHistory(\r\n  taskId: string,\r\n  agentId: string\r\n): Promise<boolean> {\r\n  try {\r\n    const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;\r\n    const keys = execSync(`redis-cli --scan --pattern \"${pattern}\"`, { encoding: 'utf8' }).trim();\r\n    return keys.length > 0;\r\n  } catch (err) {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Get the latest iteration number for an agent\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @returns Latest iteration number (0 if no history)\r\n */\r\nexport async function getLatestIteration(\r\n  taskId: string,\r\n  agentId: string\r\n): Promise<number> {\r\n  try {\r\n    const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;\r\n    const keys = execSync(`redis-cli --scan --pattern \"${pattern}\"`, { encoding: 'utf8' })\r\n      .trim()\r\n      .split('\\n')\r\n      .filter((k) => k.length > 0);\r\n\r\n    if (keys.length === 0) return 0;\r\n\r\n    // Extract iteration numbers and find max\r\n    const iterations = keys.map((key) => {\r\n      const match = key.match(/iteration-(\\d+)$/);\r\n      return match ? parseInt(match[1], 10) : 0;\r\n    });\r\n\r\n    return Math.max(...iterations);\r\n  } catch (err) {\r\n    return 0;\r\n  }\r\n}\r\n"],"names":["execSync","loadIterationHistory","taskId","agentId","currentIteration","history","i","resultKey","resultJson","encoding","trim","resultData","JSON","parse","feedbackKey","feedback","feedbackJson","feedbackData","comments","err","undefined","push","iteration","result","output","confidence","timestamp","Date","toISOString","console","error","storeIterationResult","stringify","replace","log","formatIterationHistory","length","sections","iter","substring","toFixed","lastIteration","join","hasIterationHistory","pattern","keys","getLatestIteration","split","filter","k","iterations","map","key","match","parseInt","Math","max"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-novice",
-  "version": "2.5.2",
+  "version": "2.6.0",
   "description": "AI agent orchestration framework with skills-based coordination, Redis pub/sub, and CFN Loop validation",
   "main": "dist/index.js",
   "type": "module",
@@ -67,11 +67,13 @@
     "portal:status": "./scripts/portal-status.sh"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.67.0",
     "ajv": "^8.17.1",
     "better-sqlite3": "^12.4.1",
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
     "dotenv": "^17.2.3",
+    "glob": "^11.0.3",
     "lodash": "^4.17.21",
     "redis": "^5.8.3",
     "socket.io": "^4.8.1",

package/scripts/switch-api.sh

@@ -0,0 +1,233 @@
+#!/usr/bin/env bash
+##############################################################################
+# Claude API Switcher - Main Chat & Task Tool Provider Routing
+#
+# Usage: scripts/switch-api.sh [zai|max|status]
+#
+# What it does:
+#   - zai:    Main Chat + Task tool use Z.ai (add env vars to settings.json)
+#   - max:    Main Chat + Task tool use Anthropic (remove env vars, requires re-login)
+#   - CLI:    Always uses Z.ai (controlled by .env CLAUDE_API_PROVIDER=zai)
+#
+# Settings file: .claude/settings.json (project local)
+##############################################################################
+
+set -euo pipefail
+
+SETTINGS_FILE=".claude/settings.json"
+BACKUP_DIR=".claude/backups"
+
+# Create backup directory
+mkdir -p "$BACKUP_DIR"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+##############################################################################
+# Display current configuration
+##############################################################################
+show_status() {
+    echo -e "${BLUE}═══════════════════════════════════════${NC}"
+    echo -e "${BLUE}   Claude API Provider Status${NC}"
+    echo -e "${BLUE}═══════════════════════════════════════${NC}"
+    echo ""
+
+    if [ ! -f "$SETTINGS_FILE" ]; then
+        echo -e "${YELLOW}⚠️  Settings file not found${NC}"
+        echo "   File: $SETTINGS_FILE"
+        echo ""
+        return
+    fi
+
+    # Check for Z.ai env vars in settings
+    if grep -q "ANTHROPIC_BASE_URL" "$SETTINGS_FILE" 2>/dev/null; then
+        BASE_URL=$(jq -r '.env.ANTHROPIC_BASE_URL // empty' "$SETTINGS_FILE" 2>/dev/null || echo "")
+
+        if [[ "$BASE_URL" == *"z.ai"* ]]; then
+            echo -e "${GREEN}✓ Main Chat/Task Tool:${NC} Z.ai"
+            echo "  Base URL: $BASE_URL"
+            echo "  Cost: \$0.50/1M tokens"
+        else
+            echo -e "${GREEN}✓ Main Chat/Task Tool:${NC} Custom"
+            echo "  Base URL: $BASE_URL"
+        fi
+    else
+        echo -e "${GREEN}✓ Main Chat/Task Tool:${NC} Anthropic (default)"
+        echo "  Cost: \$15/1M tokens (Claude Max subscription)"
+        echo "  Status: Requires 'claude login'"
+    fi
+
+    # Check CLI routing (.env)
+    if grep -q "CLAUDE_API_PROVIDER=zai" .env 2>/dev/null; then
+        echo -e "${GREEN}✓ CLI Agents:${NC} Z.ai (from .env)"
+        echo "  Cost: \$0.50/1M tokens"
+    else
+        echo -e "${YELLOW}⚠️  CLI Agents:${NC} Anthropic (default)"
+        echo "  Set CLAUDE_API_PROVIDER=zai in .env for cost savings"
+    fi
+
+    echo ""
+    echo -e "${BLUE}Combined Architecture:${NC}"
+    echo "  Main Chat → Task tool → Coordinator (uses Main Chat provider)"
+    echo "  Coordinator → CLI spawn → Workers (uses CLI .env provider)"
+    echo ""
+}
+
+##############################################################################
+# Switch to Z.ai for Main Chat and Task Tool
+##############################################################################
+switch_to_zai() {
+    echo -e "${BLUE}Switching Main Chat/Task Tool to Z.ai...${NC}"
+    echo ""
+
+    # Backup current settings
+    if [ -f "$SETTINGS_FILE" ]; then
+        BACKUP_NAME="settings-$(date +%Y%m%d-%H%M%S)-before-zai.json"
+        cp "$SETTINGS_FILE" "$BACKUP_DIR/$BACKUP_NAME"
+        echo -e "${GREEN}✓${NC} Backed up: $BACKUP_DIR/$BACKUP_NAME"
+    fi
+
+    # Read current settings or create empty object
+    if [ -f "$SETTINGS_FILE" ]; then
+        CURRENT_SETTINGS=$(cat "$SETTINGS_FILE")
+    else
+        CURRENT_SETTINGS='{}'
+    fi
+
+    # Add Z.ai env vars to settings
+    NEW_SETTINGS=$(echo "$CURRENT_SETTINGS" | jq '. + {
+      "env": (.env // {}) + {
+        "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
+        "ANTHROPIC_AUTH_TOKEN": "cca13d09dcd6407183efe9e24c804cca.QO8R0JxF4fucsoWL"
+      }
+    }')
+
+    echo "$NEW_SETTINGS" > "$SETTINGS_FILE"
+
+    echo ""
+    echo -e "${GREEN}═══════════════════════════════════════${NC}"
+    echo -e "${GREEN}✓ Switched to Z.ai${NC}"
+    echo -e "${GREEN}═══════════════════════════════════════${NC}"
+    echo ""
+    echo -e "${GREEN}Main Chat + Task Tool:${NC} Z.ai"
+    echo "  • All Task() spawned agents use Z.ai"
+    echo "  • Cost: \$0.50/1M tokens (97% savings)"
+    echo "  • No login required"
+    echo ""
+    echo -e "${BLUE}CLI Agents:${NC} Z.ai (from .env)"
+    echo "  • CLAUDE_API_PROVIDER=zai in .env"
+    echo "  • Independent from Main Chat routing"
+    echo ""
+    echo -e "${YELLOW}Next Steps:${NC}"
+    echo "  1. Restart Claude desktop (if running)"
+    echo "  2. Test: /cfn-loop \"Test task\""
+    echo "  3. Verify logs show: Provider: zai"
+    echo ""
+}
+
+##############################################################################
+# Switch to Anthropic Max for Main Chat and Task Tool
+##############################################################################
+switch_to_max() {
+    echo -e "${BLUE}Switching Main Chat/Task Tool to Anthropic...${NC}"
+    echo ""
+
+    # Backup current settings
+    if [ -f "$SETTINGS_FILE" ]; then
+        BACKUP_NAME="settings-$(date +%Y%m%d-%H%M%S)-before-max.json"
+        cp "$SETTINGS_FILE" "$BACKUP_DIR/$BACKUP_NAME"
+        echo -e "${GREEN}✓${NC} Backed up: $BACKUP_DIR/$BACKUP_NAME"
+    fi
+
+    # Read current settings
+    if [ -f "$SETTINGS_FILE" ]; then
+        CURRENT_SETTINGS=$(cat "$SETTINGS_FILE")
+    else
+        echo -e "${YELLOW}⚠️  No settings file found, nothing to change${NC}"
+        echo ""
+        return
+    fi
+
+    # Remove Z.ai env vars
+    NEW_SETTINGS=$(echo "$CURRENT_SETTINGS" | jq 'del(.env.ANTHROPIC_BASE_URL, .env.ANTHROPIC_AUTH_TOKEN)')
+
+    echo "$NEW_SETTINGS" > "$SETTINGS_FILE"
+
+    echo ""
+    echo -e "${GREEN}═══════════════════════════════════════${NC}"
+    echo -e "${GREEN}✓ Switched to Anthropic${NC}"
+    echo -e "${GREEN}═══════════════════════════════════════${NC}"
+    echo ""
+    echo -e "${GREEN}Main Chat + Task Tool:${NC} Anthropic (official)"
+    echo "  • Uses Claude Max subscription"
+    echo "  • Cost: \$15/1M tokens (or \$0 with unlimited plan)"
+    echo "  • ${RED}Requires re-login${NC}: Run 'claude login'"
+    echo ""
+    echo -e "${BLUE}CLI Agents:${NC} Z.ai (from .env)"
+    echo "  • CLAUDE_API_PROVIDER=zai in .env"
+    echo "  • ${GREEN}Unchanged${NC} - CLI still uses Z.ai for cost savings"
+    echo ""
+    echo -e "${YELLOW}Next Steps:${NC}"
+    echo "  1. Run: ${BLUE}claude login${NC}"
+    echo "  2. Authenticate with Anthropic"
+    echo "  3. Restart Claude desktop"
+    echo "  4. Test: Main Chat should work"
+    echo ""
+    echo -e "${YELLOW}Combined Savings:${NC}"
+    echo "  • Main Chat: \$15/1M (high quality)"
+    echo "  • CLI Workers: \$0.50/1M (cost optimized)"
+    echo "  • Overall: 88% savings vs all-Anthropic"
+    echo ""
+}
+
+##############################################################################
+# Main command handler
+##############################################################################
+case "${1:-status}" in
+    status|current|"")
+        show_status
+        ;;
+
+    zai|z.ai)
+        switch_to_zai
+        show_status
+        ;;
+
+    max|claude|anthropic)
+        switch_to_max
+        show_status
+        ;;
+
+    help|--help|-h)
+        echo "Claude API Switcher"
+        echo ""
+        echo "Usage: $0 [command]"
+        echo ""
+        echo "Commands:"
+        echo "  status    Show current API configuration (default)"
+        echo "  zai       Switch Main Chat/Task tool to Z.ai"
+        echo "  max       Switch Main Chat/Task tool to Anthropic"
+        echo ""
+        echo "Examples:"
+        echo "  $0              # Show current status"
+        echo "  $0 zai          # Use Z.ai for Main Chat"
+        echo "  $0 max          # Use Anthropic for Main Chat (requires re-login)"
+        echo ""
+        echo "Notes:"
+        echo "  • CLI agents always use Z.ai (from .env CLAUDE_API_PROVIDER=zai)"
+        echo "  • Main Chat routing affects Task() spawned agents"
+        echo "  • Settings file: .claude/settings.json"
+        echo "  • Backups saved to: .claude/backups/"
+        echo ""
+        ;;
+
+    *)
+        echo -e "${RED}Unknown command: $1${NC}"
+        echo "Run '$0 help' for usage"
+        exit 1
+        ;;
+esac