grimoire-framework 1.0.0

package/.grimoire/infrastructure/scripts/llm-routing/install-llm-routing.js

@@ -0,0 +1,282 @@
+#!/usr/bin/env node
+/**
+ * LLM Routing Installation Module
+ *
+ * Installs claude-max and claude-free commands for cost-effective
+ * LLM usage with Claude Code.
+ *
+ * - claude-max: Uses Claude Max subscription (OAuth)
+ * - claude-free: Uses DeepSeek API (~$0.14/M tokens)
+ *
+ * @module llm-routing
+ * @location .grimoire/infrastructure/scripts/llm-routing/
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const isWindows = os.platform() === 'win32';
+const LLM_ROUTING_VERSION = '1.1.0'; // Added usage tracking support
+
+/**
+ * Get the installation directory for commands
+ * @returns {string} Installation directory path
+ */
+function getInstallDir() {
+  if (isWindows) {
+    // Try npm global directory first (usually in PATH)
+    const appData = process.env.APPDATA;
+    if (appData) {
+      const npmGlobal = path.join(appData, 'npm');
+      // Create npm directory if it doesn't exist
+      if (!fs.existsSync(npmGlobal)) {
+        fs.mkdirSync(npmGlobal, { recursive: true });
+      }
+      return npmGlobal;
+    }
+    // Fallback to user profile when APPDATA is not set
+    return os.homedir();
+  } else {
+    // macOS/Linux: /usr/local/bin or ~/bin
+    const localBin = '/usr/local/bin';
+    const homeBin = path.join(os.homedir(), 'bin');
+
+    // Check if /usr/local/bin is writable
+    try {
+      fs.accessSync(localBin, fs.constants.W_OK);
+      return localBin;
+    } catch {
+      // Create ~/bin if it doesn't exist
+      if (!fs.existsSync(homeBin)) {
+        fs.mkdirSync(homeBin, { recursive: true });
+      }
+      return homeBin;
+    }
+  }
+}
+
+/**
+ * Install LLM Routing commands
+ * @param {Object} options - Installation options
+ * @param {string} options.projectRoot - Project root directory
+ * @param {string} options.templatesDir - Templates directory
+ * @param {boolean} options.enableTracking - Enable usage tracking (default: true)
+ * @param {Function} options.onProgress - Progress callback
+ * @param {Function} options.onError - Error callback
+ * @returns {Object} Installation result
+ */
+function installLLMRouting(options = {}) {
+  const {
+    projectRoot = process.cwd(),
+    templatesDir = path.join(__dirname, 'templates'),
+    enableTracking = true,
+    onProgress = console.log,
+    onError = console.error
+  } = options;
+
+  const result = {
+    success: true,
+    installDir: null,
+    filesInstalled: [],
+    envCreated: false,
+    errors: []
+  };
+
+  // Check templates exist
+  if (!fs.existsSync(templatesDir)) {
+    result.success = false;
+    result.errors.push(`Templates directory not found: ${templatesDir}`);
+    onError(`❌ Templates directory not found: ${templatesDir}`);
+    return result;
+  }
+
+  const installDir = getInstallDir();
+  result.installDir = installDir;
+  onProgress(`📂 Installing to: ${installDir}`);
+
+  // Determine which scripts to install
+  // Use tracked version of claude-free if tracking is enabled
+  const claudeFreeScript = enableTracking ? 'claude-free-tracked' : 'claude-free';
+
+  const scripts = isWindows
+    ? [`${claudeFreeScript}.cmd`, 'claude-max.cmd', 'deepseek-usage.cmd', 'deepseek-proxy.cmd']
+    : [`${claudeFreeScript}.sh`, 'claude-max.sh', 'deepseek-usage.sh', 'deepseek-proxy.sh'];
+
+  const targetNames = isWindows
+    ? ['claude-free.cmd', 'claude-max.cmd', 'deepseek-usage.cmd', 'deepseek-proxy.cmd']
+    : ['claude-free', 'claude-max', 'deepseek-usage', 'deepseek-proxy'];
+
+  // Install each script
+  scripts.forEach((script, index) => {
+    const src = path.join(templatesDir, script);
+    const dest = path.join(installDir, targetNames[index]);
+
+    if (!fs.existsSync(src)) {
+      result.success = false;
+      result.errors.push(`Source file not found: ${src}`);
+      onError(`❌ Source file not found: ${src}`);
+      return;
+    }
+
+    try {
+      fs.copyFileSync(src, dest);
+
+      // Make executable on Unix
+      if (!isWindows) {
+        fs.chmodSync(dest, 0o755);
+      }
+
+      result.filesInstalled.push(targetNames[index]);
+      onProgress(`✅ Installed: ${targetNames[index]}`);
+    } catch (error) {
+      result.success = false;
+      result.errors.push(`Failed to install ${targetNames[index]}: ${error.message}`);
+      onError(`❌ Failed to install ${targetNames[index]}: ${error.message}`);
+
+      if (!isWindows && error.code === 'EACCES') {
+        onProgress(`   Try: sudo node ${process.argv[1]}`);
+      }
+    }
+  });
+
+  // Handle .env file
+  const envExample = path.join(projectRoot, '.env.example');
+  const envFile = path.join(projectRoot, '.env');
+
+  if (fs.existsSync(envExample) && !fs.existsSync(envFile)) {
+    try {
+      fs.copyFileSync(envExample, envFile);
+      result.envCreated = true;
+      onProgress(`✅ Created .env from .env.example`);
+    } catch (error) {
+      result.success = false;
+      result.errors.push(`Failed to create .env: ${error.message}`);
+      onError(`❌ Failed to create .env: ${error.message}`);
+    }
+  }
+
+  // Final guard: if any errors were collected, mark as failure
+  if (result.errors.length > 0) {
+    result.success = false;
+  }
+
+  // Only update ~/.claude.json when installation succeeded
+  if (result.success) {
+    updateClaudeConfig(enableTracking);
+  }
+
+  return result;
+}
+
+/**
+ * Update ~/.claude.json to mark LLM routing as installed
+ * @param {boolean} trackingEnabled - Whether tracking is enabled
+ */
+function updateClaudeConfig(trackingEnabled = true) {
+  const claudeConfigPath = path.join(os.homedir(), '.claude.json');
+
+  try {
+    let config = {};
+
+    if (fs.existsSync(claudeConfigPath)) {
+      config = JSON.parse(fs.readFileSync(claudeConfigPath, 'utf8'));
+    }
+
+    config.grimoireLLMRouting = {
+      version: LLM_ROUTING_VERSION,
+      installedAt: new Date().toISOString(),
+      commands: ['claude-max', 'claude-free', 'deepseek-usage', 'deepseek-proxy'],
+      trackingEnabled
+    };
+
+    fs.writeFileSync(claudeConfigPath, JSON.stringify(config, null, 2));
+  } catch {
+    // Ignore errors updating config
+  }
+}
+
+/**
+ * Check if LLM Routing is already installed
+ * @returns {boolean}
+ */
+function isLLMRoutingInstalled() {
+  const installDir = getInstallDir();
+
+  if (isWindows) {
+    return fs.existsSync(path.join(installDir, 'claude-max.cmd')) &&
+           fs.existsSync(path.join(installDir, 'claude-free.cmd'));
+  } else {
+    return fs.existsSync(path.join(installDir, 'claude-max')) &&
+           fs.existsSync(path.join(installDir, 'claude-free'));
+  }
+}
+
+/**
+ * Get installation summary for display
+ * @param {Object} result - Installation result
+ * @returns {string[]} Summary lines
+ */
+function getInstallationSummary(result) {
+  const summary = [];
+
+  if (result.success) {
+    summary.push('');
+    summary.push('📋 LLM Routing Installation Complete!');
+    summary.push('═'.repeat(60));
+    summary.push('');
+    summary.push('Commands installed:');
+    summary.push('  • claude-max      → Uses your Claude Max subscription');
+    summary.push('  • claude-free     → Uses DeepSeek (~$0.14/M tokens) with tracking');
+    summary.push('  • deepseek-usage  → View usage statistics by alias');
+    summary.push('  • deepseek-proxy  → Manage the usage tracking proxy');
+    summary.push('');
+
+    if (result.envCreated) {
+      summary.push('Next steps:');
+      summary.push('  1. Edit .env and add your DEEPSEEK_API_KEY');
+      summary.push('     Get key at: https://platform.deepseek.com/api_keys');
+      summary.push('');
+    }
+
+    summary.push('Usage:');
+    summary.push('  claude-max          # Premium Claude experience');
+    summary.push('  claude-free         # Cost-effective development (tracked)');
+    summary.push('  deepseek-usage      # View all usage stats');
+    summary.push('  deepseek-usage <alias>  # Stats for specific alias');
+    summary.push('');
+    summary.push('Usage data saved to: ~/.grimoire/usage-tracking/deepseek-usage.json');
+    summary.push('');
+  } else {
+    summary.push('');
+    summary.push('❌ LLM Routing installation failed:');
+    result.errors.forEach(err => summary.push(`   • ${err}`));
+    summary.push('');
+  }
+
+  return summary;
+}
+
+// Export for use as module
+module.exports = {
+  installLLMRouting,
+  isLLMRoutingInstalled,
+  getInstallDir,
+  getInstallationSummary,
+  LLM_ROUTING_VERSION
+};
+
+// Run if executed directly
+if (require.main === module) {
+  console.log('\n🚀 grimoire LLM Routing Installer\n');
+
+  const result = installLLMRouting({
+    projectRoot: process.cwd(),
+    templatesDir: path.join(__dirname, 'templates')
+  });
+
+  const summary = getInstallationSummary(result);
+  summary.forEach(line => console.log(line));
+}
+
+

package/.grimoire/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd

@@ -0,0 +1,129 @@
+@echo off
+:: Claude Code - DeepSeek Native Mode with Usage Tracking
+:: Routes through local proxy to track per-alias usage
+:: Cost: ~$0.14/M tokens with tool calling support
+
+setlocal enabledelayedexpansion
+
+:: Configuration
+set "PROXY_PORT=8787"
+set "ALIAS=claude-free"
+
+:: Find tracker script
+if defined grimoire_HOME (
+    set "TRACKER_SCRIPT=%grimoire_HOME%\.grimoire\infrastructure\scripts\llm-routing\usage-tracker\index.js"
+    if exist "!TRACKER_SCRIPT!" goto :tracker_found
+)
+set "TRACKER_SCRIPT=%USERPROFILE%\grimoire\.grimoire\infrastructure\scripts\llm-routing\usage-tracker\index.js"
+if exist "%TRACKER_SCRIPT%" goto :tracker_found
+set "TRACKER_SCRIPT=%USERPROFILE%\Workspaces\grimoire\grimoireAI\grimoire\.grimoire\infrastructure\scripts\llm-routing\usage-tracker\index.js"
+if exist "%TRACKER_SCRIPT%" goto :tracker_found
+set "TRACKER_SCRIPT=%~dp0..\usage-tracker\index.js"
+:tracker_found
+
+:: Find project root (look for .env file)
+set "PROJECT_ROOT=%CD%"
+set /a "LOOP_COUNT=0"
+:find_env
+set /a "LOOP_COUNT+=1"
+if %LOOP_COUNT% gtr 50 goto :no_env
+if exist "%PROJECT_ROOT%\.env" goto :found_env
+if "%PROJECT_ROOT%"=="%PROJECT_ROOT:~0,3%" goto :no_env
+for %%i in ("%PROJECT_ROOT%\..") do set "PROJECT_ROOT=%%~fi"
+goto :find_env
+
+:no_env
+if not "%DEEPSEEK_API_KEY%"=="" goto :use_env_key
+
+echo.
+echo [91mERROR: No .env file found and DEEPSEEK_API_KEY not set![0m
+echo.
+echo Options:
+echo   1. Create .env in your project: cp .env.example .env
+echo   2. Set DEEPSEEK_API_KEY in the .env file
+echo   3. Or set it globally: setx DEEPSEEK_API_KEY "sk-your-key"
+echo.
+echo Get your API key at: https://platform.deepseek.com/api_keys
+echo.
+pause
+exit /b 1
+
+:found_env
+:: Load DEEPSEEK_API_KEY from .env
+for /f "usebackq eol=# tokens=1,* delims==" %%a in ("%PROJECT_ROOT%\.env") do (
+    if "%%a"=="DEEPSEEK_API_KEY" set "DEEPSEEK_API_KEY=%%b"
+)
+set "DEEPSEEK_API_KEY=!DEEPSEEK_API_KEY:"=!"
+
+if "!DEEPSEEK_API_KEY!"=="" (
+    echo.
+    echo [91mERROR: DEEPSEEK_API_KEY not found in .env![0m
+    echo.
+    pause
+    exit /b 1
+)
+
+:use_env_key
+:: Check if proxy is running
+curl -s http://127.0.0.1:%PROXY_PORT%/health >nul 2>&1
+if %errorlevel% neq 0 (
+    echo.
+    echo [93mUsage Tracker proxy not running. Starting in background...[0m
+
+    :: Start proxy in background
+    start /b "" node "%TRACKER_SCRIPT%" start --port=%PROXY_PORT% --alias=%ALIAS% >nul 2>&1
+
+    :: Wait for proxy to start
+    timeout /t 2 /nobreak >nul
+
+    :: Verify it started
+    curl -s http://127.0.0.1:%PROXY_PORT%/health >nul 2>&1
+    if %errorlevel% neq 0 (
+        echo [91mFailed to start proxy. Falling back to direct connection.[0m
+        goto :direct_connection
+    )
+    echo [92mProxy started successfully![0m
+)
+
+:: Use local proxy (proxy will forward to DeepSeek with original API key)
+set ANTHROPIC_BASE_URL=http://127.0.0.1:%PROXY_PORT%/anthropic
+set ANTHROPIC_API_KEY=%DEEPSEEK_API_KEY%
+set ANTHROPIC_MODEL=deepseek-chat
+set API_TIMEOUT_MS=600000
+
+echo.
+echo [92mClaude Code - DeepSeek Native Mode (TRACKED)[0m
+echo Proxy: 127.0.0.1:%PROXY_PORT%
+echo Alias: %ALIAS%
+echo [92mTool Calling: SUPPORTED[0m
+echo Cost: ~$0.14/M tokens
+echo.
+echo [96mUsage tracking enabled. Run 'deepseek-usage' to view stats.[0m
+echo.
+
+goto :run_claude
+
+:direct_connection
+:: Direct connection without tracking
+set ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
+set ANTHROPIC_API_KEY=%DEEPSEEK_API_KEY%
+set ANTHROPIC_MODEL=deepseek-chat
+set API_TIMEOUT_MS=600000
+
+echo.
+echo [92mClaude Code - DeepSeek Native Mode (DIRECT)[0m
+echo Endpoint: api.deepseek.com/anthropic
+echo [93mUsage tracking: DISABLED (proxy not running)[0m
+echo.
+
+:run_claude
+endlocal & set "ANTHROPIC_BASE_URL=%ANTHROPIC_BASE_URL%" & set "ANTHROPIC_API_KEY=%DEEPSEEK_API_KEY%" & set "ANTHROPIC_MODEL=deepseek-chat" & set "API_TIMEOUT_MS=600000"
+
+>&2 echo.
+>&2 echo [93mWARNING: Running with --dangerously-skip-permissions (no confirmation prompts)[0m
+>&2 echo [93mOnly use in trusted repositories/environments.[0m
+>&2 echo.
+
+claude --dangerously-skip-permissions %*
+
+

package/.grimoire/infrastructure/scripts/llm-routing/templates/claude-free-tracked.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+# Claude Code - DeepSeek Native Mode with Usage Tracking
+# Routes through local proxy to track per-alias usage
+# Cost: ~$0.14/M tokens with tool calling support
+
+PROXY_PORT=8787
+ALIAS="claude-free"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TRACKER_SCRIPT="$SCRIPT_DIR/../usage-tracker/index.js"
+
+# Colors
+RED='\033[0;91m'
+GREEN='\033[0;92m'
+YELLOW='\033[0;93m'
+CYAN='\033[0;96m'
+NC='\033[0m' # No Color
+
+# Find project root (look for .env file)
+find_env() {
+    local dir="$PWD"
+    local count=0
+    while [ $count -lt 50 ]; do
+        if [ -f "$dir/.env" ]; then
+            echo "$dir"
+            return 0
+        fi
+        if [ "$dir" = "/" ]; then
+            return 1
+        fi
+        dir="$(dirname "$dir")"
+        ((count++))
+    done
+    return 1
+}
+
+PROJECT_ROOT=$(find_env)
+
+if [ -z "$PROJECT_ROOT" ] && [ -z "$DEEPSEEK_API_KEY" ]; then
+    echo -e "${RED}ERROR: No .env file found and DEEPSEEK_API_KEY not set!${NC}"
+    echo ""
+    echo "Options:"
+    echo "  1. Create .env in your project: cp .env.example .env"
+    echo "  2. Set DEEPSEEK_API_KEY in the .env file"
+    echo "  3. Or export it: export DEEPSEEK_API_KEY='sk-your-key'"
+    echo ""
+    echo "Get your API key at: https://platform.deepseek.com/api_keys"
+    exit 1
+fi
+
+# Load DEEPSEEK_API_KEY from .env if not already set
+if [ -z "$DEEPSEEK_API_KEY" ] && [ -n "$PROJECT_ROOT" ]; then
+    DEEPSEEK_API_KEY=$(grep -E '^DEEPSEEK_API_KEY=' "$PROJECT_ROOT/.env" | cut -d'=' -f2- | tr -d '"' | tr -d "'")
+fi
+
+if [ -z "$DEEPSEEK_API_KEY" ]; then
+    echo -e "${RED}ERROR: DEEPSEEK_API_KEY not found!${NC}"
+    exit 1
+fi
+
+# Check if proxy is running
+check_proxy() {
+    curl -s "http://127.0.0.1:$PROXY_PORT/health" > /dev/null 2>&1
+}
+
+# Start proxy if not running
+if ! check_proxy; then
+    echo -e "${YELLOW}Usage Tracker proxy not running. Starting in background...${NC}"
+
+    # Start proxy in background
+    nohup node "$TRACKER_SCRIPT" start --port=$PROXY_PORT --alias=$ALIAS > /dev/null 2>&1 &
+
+    # Wait for proxy to start
+    sleep 2
+
+    if ! check_proxy; then
+        echo -e "${RED}Failed to start proxy. Falling back to direct connection.${NC}"
+        export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
+    else
+        echo -e "${GREEN}Proxy started successfully!${NC}"
+        export ANTHROPIC_BASE_URL="http://127.0.0.1:$PROXY_PORT/anthropic"
+    fi
+else
+    export ANTHROPIC_BASE_URL="http://127.0.0.1:$PROXY_PORT/anthropic"
+fi
+
+export ANTHROPIC_API_KEY="$DEEPSEEK_API_KEY"
+export ANTHROPIC_MODEL="deepseek-chat"
+export API_TIMEOUT_MS=600000
+
+echo ""
+echo -e "${GREEN}Claude Code - DeepSeek Native Mode (TRACKED)${NC}"
+if [[ "$ANTHROPIC_BASE_URL" == *"127.0.0.1"* ]]; then
+    echo "Proxy: 127.0.0.1:$PROXY_PORT"
+    echo "Alias: $ALIAS"
+    echo -e "${CYAN}Usage tracking enabled. Run 'deepseek-usage' to view stats.${NC}"
+else
+    echo "Endpoint: api.deepseek.com/anthropic"
+    echo -e "${YELLOW}Usage tracking: DISABLED (proxy not running)${NC}"
+fi
+echo -e "${GREEN}Tool Calling: SUPPORTED${NC}"
+echo "Cost: ~\$0.14/M tokens"
+echo ""
+
+echo -e "${YELLOW}WARNING: Running with --dangerously-skip-permissions (no confirmation prompts)${NC}" >&2
+echo -e "${YELLOW}Only use in trusted repositories/environments.${NC}" >&2
+echo "" >&2
+
+exec claude --dangerously-skip-permissions "$@"

package/.grimoire/infrastructure/scripts/llm-routing/templates/claude-free.cmd

@@ -0,0 +1,80 @@
+@echo off
+:: Claude Code - DeepSeek Native Mode (Low-Cost)
+:: Loads API key from project .env file
+:: Cost: ~$0.14/M tokens with tool calling support
+
+setlocal enabledelayedexpansion
+
+:: Find project root (look for .env file)
+:: Loop guard prevents infinite loop on UNC paths
+set "PROJECT_ROOT=%CD%"
+set /a "LOOP_COUNT=0"
+:find_env
+set /a "LOOP_COUNT+=1"
+if %LOOP_COUNT% gtr 50 goto :no_env
+if exist "%PROJECT_ROOT%\.env" goto :found_env
+if "%PROJECT_ROOT%"=="%PROJECT_ROOT:~0,3%" goto :no_env
+for %%i in ("%PROJECT_ROOT%\..") do set "PROJECT_ROOT=%%~fi"
+goto :find_env
+
+:no_env
+:: Check if DEEPSEEK_API_KEY is set in environment
+if not "%DEEPSEEK_API_KEY%"=="" goto :use_env_key
+
+echo.
+echo [91mERROR: No .env file found and DEEPSEEK_API_KEY not set![0m
+echo.
+echo Options:
+echo   1. Create .env in your project: cp .env.example .env
+echo   2. Set DEEPSEEK_API_KEY in the .env file
+echo   3. Or set it globally: setx DEEPSEEK_API_KEY "sk-your-key"
+echo.
+echo Get your API key at: https://platform.deepseek.com/api_keys
+echo.
+pause
+exit /b 1
+
+:found_env
+:: Load DEEPSEEK_API_KEY from .env (skip comments starting with #)
+for /f "usebackq eol=# tokens=1,* delims==" %%a in ("%PROJECT_ROOT%\.env") do (
+    if "%%a"=="DEEPSEEK_API_KEY" set "DEEPSEEK_API_KEY=%%b"
+)
+
+:: Remove quotes if present
+set "DEEPSEEK_API_KEY=!DEEPSEEK_API_KEY:"=!"
+
+if "!DEEPSEEK_API_KEY!"=="" (
+    echo.
+    echo [91mERROR: DEEPSEEK_API_KEY not found in .env![0m
+    echo.
+    echo Add to your .env file:
+    echo   DEEPSEEK_API_KEY=sk-your-key
+    echo.
+    echo Get your API key at: https://platform.deepseek.com/api_keys
+    echo.
+    pause
+    exit /b 1
+)
+
+:use_env_key
+:: Set DeepSeek native Anthropic endpoint (SUPPORTS TOOL CALLING!)
+set ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
+set ANTHROPIC_API_KEY=%DEEPSEEK_API_KEY%
+set ANTHROPIC_MODEL=deepseek-chat
+set API_TIMEOUT_MS=600000
+
+echo.
+echo [92mClaude Code - DeepSeek Native Mode[0m
+echo Endpoint: api.deepseek.com/anthropic
+echo [92mTool Calling: SUPPORTED[0m
+echo Cost: ~$0.14/M tokens
+echo.
+
+endlocal & set "ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic" & set "ANTHROPIC_API_KEY=%DEEPSEEK_API_KEY%" & set "ANTHROPIC_MODEL=deepseek-chat" & set "API_TIMEOUT_MS=600000"
+
+>&2 echo.
+>&2 echo [93mWARNING: Running with --dangerously-skip-permissions (no confirmation prompts)[0m
+>&2 echo [93mOnly use in trusted repositories/environments.[0m
+>&2 echo.
+
+claude --dangerously-skip-permissions %*

package/.grimoire/infrastructure/scripts/llm-routing/templates/claude-free.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+# Claude Code - DeepSeek Native Mode (Low-Cost)
+# Loads API key from project .env file
+# Cost: ~$0.14/M tokens with tool calling support
+
+# Find project root (look for .env file)
+find_env() {
+    local dir="$PWD"
+    while [[ "$dir" != "/" ]]; do
+        if [[ -f "$dir/.env" ]]; then
+            echo "$dir"
+            return 0
+        fi
+        dir="$(dirname "$dir")"
+    done
+    return 1
+}
+
+# Try to load from .env
+PROJECT_ROOT=$(find_env)
+
+if [[ -n "$PROJECT_ROOT" ]]; then
+    # Load DEEPSEEK_API_KEY from .env
+    if [[ -f "$PROJECT_ROOT/.env" ]]; then
+        export $(grep -E '^DEEPSEEK_API_KEY=' "$PROJECT_ROOT/.env" | xargs)
+    fi
+fi
+
+# Check if key is set (from .env or environment)
+if [[ -z "$DEEPSEEK_API_KEY" ]]; then
+    echo ""
+    echo -e "\033[91mERROR: DEEPSEEK_API_KEY not found!\033[0m"
+    echo ""
+    echo "Options:"
+    echo "  1. Create .env in your project: cp .env.example .env"
+    echo "  2. Add DEEPSEEK_API_KEY=sk-your-key to .env"
+    echo "  3. Or export it: export DEEPSEEK_API_KEY=sk-your-key"
+    echo ""
+    echo "Get your API key at: https://platform.deepseek.com/api_keys"
+    echo ""
+    exit 1
+fi
+
+# Set DeepSeek native Anthropic endpoint (SUPPORTS TOOL CALLING!)
+export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
+export ANTHROPIC_API_KEY="$DEEPSEEK_API_KEY"
+export ANTHROPIC_MODEL="deepseek-chat"
+export API_TIMEOUT_MS=600000
+
+echo ""
+echo -e "\033[92mClaude Code - DeepSeek Native Mode\033[0m"
+echo "Endpoint: api.deepseek.com/anthropic"
+echo -e "\033[92mTool Calling: SUPPORTED\033[0m"
+echo "Cost: ~\$0.14/M tokens"
+echo ""
+
+>&2 echo ""
+>&2 echo -e "\033[93mWARNING: Running with --dangerously-skip-permissions (no confirmation prompts)\033[0m"
+>&2 echo -e "\033[93mOnly use in trusted repositories/environments.\033[0m"
+>&2 echo ""
+
+claude --dangerously-skip-permissions "$@"

package/.grimoire/infrastructure/scripts/llm-routing/templates/claude-max.cmd

@@ -0,0 +1,26 @@
+@echo off
+:: Claude Code - Claude Max Mode
+:: Uses your Claude Max subscription via OAuth (claude.ai login)
+:: This is the premium Claude Code experience
+
+:: Clear ALL alternative provider settings to force OAuth
+set "ANTHROPIC_BASE_URL="
+set "ANTHROPIC_AUTH_TOKEN="
+set "ANTHROPIC_MODEL="
+set "ANTHROPIC_SMALL_FAST_MODEL="
+set "ANTHROPIC_API_KEY="
+set "DEEPSEEK_API_KEY="
+set "OPENROUTER_API_KEY="
+set "API_TIMEOUT_MS="
+
+echo.
+echo [92m========================================[0m
+echo [92m  Claude Max Mode - OAuth/Claude.ai[0m
+echo [92m========================================[0m
+echo.
+echo Using your Claude Max subscription (claude.ai login)
+echo If you see "API Usage Billing", run: claude /logout
+echo Then restart and login again with your Max account.
+echo.
+
+claude --dangerously-skip-permissions %*