claude-code-templates 1.26.3 → 1.27.0

package/components/sandbox/docker/execute.js

@@ -0,0 +1,251 @@
+#!/usr/bin/env node
+
+/**
+ * Docker Sandbox Executor
+ * Runs inside Docker container using Claude Agent SDK
+ */
+
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import fs from 'fs/promises';
+import path from 'path';
+import { spawn } from 'child_process';
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+const prompt = args[0] || 'Hello, Claude!';
+const componentsToInstall = args[1] || '';
+const anthropicApiKey = process.env.ANTHROPIC_API_KEY;
+
+// Validate API key
+if (!anthropicApiKey) {
+  console.error('❌ Error: ANTHROPIC_API_KEY environment variable is required');
+  process.exit(1);
+}
+
+console.log('🐳 Docker Sandbox Executor');
+console.log('═══════════════════════════════════════\n');
+
+/**
+ * Install Claude Code components if specified
+ */
+async function installComponents() {
+  if (!componentsToInstall || componentsToInstall.trim() === '') {
+    return true;
+  }
+
+  console.log('📦 Installing components...');
+  console.log(`   Components: ${componentsToInstall}\n`);
+
+  return new Promise((resolve) => {
+    const installCmd = `npx claude-code-templates@latest ${componentsToInstall} --yes`;
+
+    const child = spawn('sh', ['-c', installCmd], {
+      stdio: 'inherit',
+      env: process.env
+    });
+
+    child.on('close', (code) => {
+      if (code === 0) {
+        console.log('\n✅ Components installed successfully\n');
+        resolve(true);
+      } else {
+        console.log('\n⚠️  Component installation had warnings (continuing...)\n');
+        resolve(true); // Continue even if installation has warnings
+      }
+    });
+
+    child.on('error', (error) => {
+      console.error(`❌ Installation error: ${error.message}`);
+      resolve(false);
+    });
+  });
+}
+
+/**
+ * Execute Claude Code query using Agent SDK
+ */
+async function executeQuery() {
+  try {
+    console.log('🤖 Executing Claude Code...');
+    console.log(`   Prompt: "${prompt.substring(0, 80)}${prompt.length > 80 ? '...' : ''}"\n`);
+    console.log('─'.repeat(60));
+    console.log('📝 CLAUDE OUTPUT:');
+    console.log('─'.repeat(60) + '\n');
+
+    // Enhance prompt with working directory context
+    const enhancedPrompt = `${prompt}\n\nNote: Your current working directory is /app. When creating files, save them in the current directory (/app) so they can be captured in the output.`;
+
+    // query() returns an async generator - we need to iterate it
+    const generator = query({
+      prompt: enhancedPrompt,
+      options: {
+        apiKey: anthropicApiKey,
+        model: 'claude-sonnet-4-5',
+        permissionMode: 'bypassPermissions',  // Auto-allow all tool uses
+      }
+    });
+
+    let assistantResponses = [];
+    let messageCount = 0;
+
+    // Iterate through the async generator
+    for await (const message of generator) {
+      messageCount++;
+
+      if (message.type === 'assistant') {
+        // Extract text from assistant message content
+        if (message.message && message.message.content) {
+          const content = Array.isArray(message.message.content)
+            ? message.message.content
+            : [message.message.content];
+
+          content.forEach(block => {
+            if (block.type === 'text') {
+              console.log(block.text);
+              assistantResponses.push(block.text);
+            }
+          });
+        }
+      } else if (message.type === 'result') {
+        // Show final result metadata
+        console.log('\n' + '─'.repeat(60));
+        console.log(`✅ Execution completed (${message.num_turns} turn${message.num_turns > 1 ? 's' : ''})`);
+        console.log(`   Duration: ${message.duration_ms}ms`);
+        console.log(`   Cost: $${message.total_cost_usd.toFixed(5)}`);
+        console.log('─'.repeat(60) + '\n');
+      }
+    }
+
+    // Show response summary
+    const responseText = assistantResponses.join('\n');
+    if (responseText) {
+      console.log('📄 Response Summary:');
+      console.log(`   ${messageCount} message(s) received`);
+      console.log(`   ${assistantResponses.length} assistant response(s)`);
+      console.log(`   ${responseText.length} characters generated`);
+      console.log('');
+    }
+
+    return true;
+  } catch (error) {
+    console.error('\n❌ Execution error:', error.message);
+    if (error.stack) {
+      console.error('\nStack trace:');
+      console.error(error.stack);
+    }
+    return false;
+  }
+}
+
+/**
+ * Find and copy generated files to output directory
+ */
+async function copyGeneratedFiles() {
+  try {
+    console.log('📁 Searching for generated files...\n');
+
+    // Common file extensions to look for
+    const extensions = [
+      'js', 'jsx', 'ts', 'tsx',
+      'py', 'html', 'css', 'scss',
+      'json', 'md', 'yaml', 'yml',
+      'txt', 'sh', 'bash'
+    ];
+
+    // Search for files in multiple directories
+    const { execSync } = await import('child_process');
+
+    const findPattern = extensions.map(ext => `-name "*.${ext}"`).join(' -o ');
+
+    // Search in /app and /tmp for generated files
+    const searchPaths = ['/app', '/tmp'];
+    let allFiles = [];
+
+    for (const searchPath of searchPaths) {
+      const findCmd = `find ${searchPath} -type f \\( ${findPattern} \\) ! -path "*/node_modules/*" ! -path "*/.npm/*" ! -path "/app/execute.js" ! -path "/app/package*.json" -newer /app/execute.js 2>/dev/null | head -50`;
+
+      try {
+        const output = execSync(findCmd, { encoding: 'utf8' });
+        const files = output.trim().split('\n').filter(f => f.trim());
+        allFiles = allFiles.concat(files);
+      } catch (error) {
+        // Continue to next search path
+      }
+    }
+
+    if (allFiles.length === 0) {
+      console.log('ℹ️  No generated files found\n');
+      return;
+    }
+
+    console.log(`📦 Found ${allFiles.length} file(s):\n`);
+
+    // Copy files to output directory preserving structure
+    let copiedCount = 0;
+    for (const file of allFiles) {
+      try {
+        // Determine relative path based on source directory
+        let relativePath;
+        if (file.startsWith('/app/')) {
+          relativePath = file.replace('/app/', '');
+        } else if (file.startsWith('/tmp/')) {
+          relativePath = file.replace('/tmp/', '');
+        } else {
+          relativePath = path.basename(file);
+        }
+
+        const outputPath = path.join('/output', relativePath);
+
+        // Create directory structure
+        await fs.mkdir(path.dirname(outputPath), { recursive: true });
+
+        // Copy file
+        await fs.copyFile(file, outputPath);
+
+        console.log(`   ✅ ${relativePath}`);
+        copiedCount++;
+      } catch (error) {
+        console.log(`   ⚠️  Failed to copy: ${file}`);
+      }
+    }
+
+    if (copiedCount > 0) {
+      console.log(`\n✅ Copied ${copiedCount} file(s) to output directory\n`);
+    }
+  } catch (error) {
+    console.error('❌ Error copying files:', error.message);
+  }
+}
+
+/**
+ * Main execution flow
+ */
+async function main() {
+  try {
+    // Step 1: Install components
+    const installSuccess = await installComponents();
+    if (!installSuccess) {
+      console.error('❌ Component installation failed');
+      process.exit(1);
+    }
+
+    // Step 2: Execute Claude query
+    const executeSuccess = await executeQuery();
+    if (!executeSuccess) {
+      console.error('❌ Query execution failed');
+      process.exit(1);
+    }
+
+    // Step 3: Copy generated files
+    await copyGeneratedFiles();
+
+    console.log('🎉 Docker sandbox execution completed successfully!');
+    process.exit(0);
+  } catch (error) {
+    console.error('❌ Fatal error:', error.message);
+    process.exit(1);
+  }
+}
+
+// Run main function
+main();

package/components/sandbox/docker/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "claude-code-docker-sandbox",
+  "version": "1.0.0",
+  "description": "Docker sandbox for Claude Code execution with Claude Agent SDK",
+  "main": "docker-launcher.js",
+  "type": "module",
+  "scripts": {
+    "build": "docker build -t claude-sandbox .",
+    "clean": "docker rmi claude-sandbox || true"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.1.30"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "claude",
+    "docker",
+    "sandbox",
+    "ai",
+    "agent"
+  ],
+  "author": "Claude Code Templates",
+  "license": "MIT"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-templates",
-  "version": "1.26.3",
+  "version": "1.27.0",
   "description": "CLI tool to setup Claude Code configurations with framework-specific commands, automation hooks and MCP Servers for your projects",
   "main": "src/index.js",
   "bin": {
@@ -94,6 +94,7 @@
     "src/",
     "components/sandbox/e2b/",
     "components/sandbox/cloudflare/",
+    "components/sandbox/docker/",
     "README.md"
   ],
   "devDependencies": {

package/src/index.js

@@ -126,6 +126,10 @@ async function createClaudeConfig(options = {}) {
 
   // Handle sandbox execution FIRST (before individual components)
   if (options.sandbox) {
+    trackingService.trackCommandExecution('sandbox', {
+      provider: options.sandbox,
+      hasPrompt: !!options.prompt
+    });
     await executeSandbox(options, targetDir);
     return;
   }
@@ -174,24 +178,28 @@ async function createClaudeConfig(options = {}) {
   
   // Handle command stats analysis (both singular and plural)
   if (options.commandStats || options.commandsStats) {
+    trackingService.trackCommandExecution('command-stats');
     await runCommandStats(options);
     return;
   }
-  
+
   // Handle hook stats analysis (both singular and plural)
   if (options.hookStats || options.hooksStats) {
+    trackingService.trackCommandExecution('hook-stats');
     await runHookStats(options);
     return;
   }
-  
+
   // Handle MCP stats analysis (both singular and plural)
   if (options.mcpStats || options.mcpsStats) {
+    trackingService.trackCommandExecution('mcp-stats');
     await runMCPStats(options);
     return;
   }
   
   // Handle analytics dashboard
   if (options.analytics) {
+    trackingService.trackCommandExecution('analytics', { tunnel: options.tunnel || false });
     trackingService.trackAnalyticsDashboard({ page: 'dashboard', source: 'command_line' });
     await runAnalytics(options);
     return;
@@ -199,6 +207,7 @@ async function createClaudeConfig(options = {}) {
 
   // Handle plugin dashboard
   if (options.plugins) {
+    trackingService.trackCommandExecution('plugins');
     trackingService.trackAnalyticsDashboard({ page: 'plugins', source: 'command_line' });
     await runPluginDashboard(options);
     return;
@@ -206,20 +215,23 @@ async function createClaudeConfig(options = {}) {
 
   // Handle chats dashboard (now points to mobile chats interface)
   if (options.chats) {
+    trackingService.trackCommandExecution('chats', { tunnel: options.tunnel || false });
     trackingService.trackAnalyticsDashboard({ page: 'chats-mobile', source: 'command_line' });
     await startChatsMobile(options);
     return;
   }
-  
+
   // Handle agents dashboard (separate from chats)
   if (options.agents) {
+    trackingService.trackCommandExecution('agents', { tunnel: options.tunnel || false });
     trackingService.trackAnalyticsDashboard({ page: 'agents', source: 'command_line' });
     await runAnalytics({ ...options, openTo: 'agents' });
     return;
   }
-  
+
   // Handle mobile chats interface
   if (options.chatsMobile) {
+    trackingService.trackCommandExecution('chats-mobile', { tunnel: options.tunnel || false });
     trackingService.trackAnalyticsDashboard({ page: 'chats-mobile', source: 'command_line' });
     await startChatsMobile(options);
     return;
@@ -269,8 +281,9 @@ async function createClaudeConfig(options = {}) {
   // Handle health check
   let shouldRunSetup = false;
   if (options.healthCheck || options.health || options.check || options.verify) {
+    trackingService.trackCommandExecution('health-check');
     const healthResult = await runHealthCheck();
-    
+
     // Track health check usage
     trackingService.trackHealthCheck({
       setup_recommended: healthResult.runSetup,
@@ -2434,37 +2447,38 @@ async function launchClaudeCodeStudio(options, targetDir) {
 }
 
 async function executeSandbox(options, targetDir) {
-  const { sandbox, command, mcp, setting, hook, e2bApiKey, anthropicApiKey } = options;
+  const { sandbox, command, mcp, setting, hook, e2bApiKey, anthropicApiKey, yes } = options;
   let { agent, prompt } = options;
-  
+
   // Validate sandbox provider
-  if (sandbox !== 'e2b' && sandbox !== 'cloudflare') {
+  if (sandbox !== 'e2b' && sandbox !== 'cloudflare' && sandbox !== 'docker') {
     console.log(chalk.red('❌ Error: Invalid sandbox provider'));
-    console.log(chalk.yellow('💡 Available providers: e2b, cloudflare'));
+    console.log(chalk.yellow('💡 Available providers: e2b, cloudflare, docker'));
     console.log(chalk.gray('   Example: --sandbox e2b --prompt "Create a web app"'));
     console.log(chalk.gray('   Example: --sandbox cloudflare --prompt "Calculate factorial of 5"'));
+    console.log(chalk.gray('   Example: --sandbox docker --prompt "Write a function"'));
     return;
   }
-  
-  // Interactive agent selection if not provided
-  if (!agent) {
+
+  // Interactive agent selection if not provided and --yes not used
+  if (!agent && !yes) {
     const inquirer = require('inquirer');
-    
+
     console.log(chalk.blue('\n🤖 Agent Selection'));
     console.log(chalk.cyan('═══════════════════════════════════════'));
     console.log(chalk.gray('Select one or more agents for your task (use SPACE to select, ENTER to confirm).\n'));
-    
+
     // Fetch available agents
     console.log(chalk.gray('⏳ Fetching available agents...'));
     const agents = await getAvailableAgentsFromGitHub();
-    
+
     // Format agents for selection with full path
     const agentChoices = agents.map(a => ({
       name: `${a.path} ${chalk.gray(`- ${a.category}`)}`,
       value: a.path,  // This already includes folder/agent-name format
       short: a.path
     }));
-    
+
     // First ask if they want to select agents
     const { wantAgents } = await inquirer.prompt([{
       type: 'confirm',
@@ -2472,7 +2486,7 @@ async function executeSandbox(options, targetDir) {
       message: 'Do you want to select specific agents for this task?',
       default: true
     }]);
-    
+
     if (wantAgents) {
       const { selectedAgents } = await inquirer.prompt([{
         type: 'checkbox',
@@ -2482,7 +2496,7 @@ async function executeSandbox(options, targetDir) {
         pageSize: 15
         // Removed validation - allow empty selection
       }]);
-      
+
       if (selectedAgents && selectedAgents.length > 0) {
         // Join multiple agents with comma
         agent = selectedAgents.join(',');
@@ -2494,6 +2508,9 @@ async function executeSandbox(options, targetDir) {
     } else {
       console.log(chalk.yellow('⚠️ Continuing without specific agents'));
     }
+  } else if (!agent && yes) {
+    // --yes flag used without --agent, proceed without agents
+    console.log(chalk.yellow('⚠️ No agent specified, continuing without specific agents'));
   }
   
   // Get prompt from user if not provided
@@ -2590,6 +2607,19 @@ async function executeSandbox(options, targetDir) {
 
     // Execute Cloudflare sandbox
     await executeCloudflareSandbox({ sandbox, agent, prompt, command, mcp, setting, hook, anthropicKey }, targetDir);
+
+  } else if (sandbox === 'docker') {
+    if (!anthropicKey) {
+      console.log(chalk.red('❌ Error: Anthropic API key is required for Docker sandbox'));
+      console.log(chalk.yellow('💡 Options:'));
+      console.log(chalk.gray('   1. Set environment variable: ANTHROPIC_API_KEY=your_key'));
+      console.log(chalk.gray('   2. Use CLI parameter: --anthropic-api-key your_key'));
+      console.log(chalk.blue('   Get your key at: https://console.anthropic.com'));
+      return;
+    }
+
+    // Execute Docker sandbox
+    await executeDockerSandbox({ sandbox, agent, prompt, command, mcp, setting, hook, anthropicKey, yes: options.yes }, targetDir);
   }
 }
 
@@ -2804,6 +2834,199 @@ async function executeCloudflareSandbox(options, targetDir) {
   }
 }
 
+async function executeDockerSandbox(options, targetDir) {
+  const { agent, command, mcp, setting, hook, prompt, anthropicKey, yes } = options;
+
+  console.log(chalk.blue('\n🐳 Docker Sandbox Execution'));
+  console.log(chalk.cyan('═══════════════════════════════════════'));
+
+  if (agent) {
+    const agentList = agent.split(',');
+    if (agentList.length > 1) {
+      console.log(chalk.white(`📋 Agents (${agentList.length}):`));
+      agentList.forEach(a => console.log(chalk.yellow(`   • ${a.trim()}`)));
+    } else {
+      console.log(chalk.white(`📋 Agent: ${chalk.yellow(agent)}`));
+    }
+  } else {
+    console.log(chalk.white(`📋 Agent: ${chalk.yellow('default')}`));
+  }
+
+  const truncatedPrompt = prompt.length > 80 ? prompt.substring(0, 80) + '...' : prompt;
+  console.log(chalk.white(`💭 Prompt: ${chalk.cyan('"' + truncatedPrompt + '"')}`));
+  console.log(chalk.white(`🐳 Provider: ${chalk.green('Docker Local')}`));
+  console.log(chalk.gray('\n🔧 Execution details:'));
+  console.log(chalk.gray('   • Uses Claude Agent SDK for execution'));
+  console.log(chalk.gray('   • Executes in isolated Docker container'));
+  console.log(chalk.gray('   • Local execution with full filesystem access\n'));
+
+  // Skip confirmation prompt if --yes flag is used
+  if (!yes) {
+    const inquirer = require('inquirer');
+
+    const { shouldExecute } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'shouldExecute',
+      message: 'Execute this prompt in Docker sandbox?',
+      default: true
+    }]);
+
+    if (!shouldExecute) {
+      console.log(chalk.yellow('⏹️  Docker sandbox execution cancelled by user.'));
+      return;
+    }
+  }
+
+  try {
+    console.log(chalk.blue('🔮 Setting up Docker sandbox environment...'));
+
+    const spinner = ora('Installing Docker sandbox component...').start();
+
+    // Create .claude/sandbox/docker directory
+    const sandboxDir = path.join(targetDir, '.claude', 'sandbox', 'docker');
+    await fs.ensureDir(sandboxDir);
+
+    // Copy Docker component files
+    const componentsDir = path.join(__dirname, '..', 'components', 'sandbox', 'docker');
+
+    try {
+      if (await fs.pathExists(componentsDir)) {
+        console.log(chalk.gray('📦 Using local Docker component files...'));
+        console.log(chalk.dim(`   Source: ${componentsDir}`));
+        console.log(chalk.dim(`   Target: ${sandboxDir}`));
+
+        // Copy all files from docker directory
+        await fs.copy(componentsDir, sandboxDir, {
+          overwrite: true
+        });
+
+        // Verify files were copied
+        const copiedFiles = await fs.readdir(sandboxDir);
+        console.log(chalk.dim(`   Copied ${copiedFiles.length} items`));
+        if (copiedFiles.length === 0) {
+          throw new Error('No files were copied from Docker component directory');
+        }
+      } else {
+        throw new Error(`Docker component files not found at: ${componentsDir}`);
+      }
+    } catch (error) {
+      spinner.fail(`Failed to install Docker component: ${error.message}`);
+      throw error;
+    }
+
+    spinner.succeed('Docker sandbox component installed successfully');
+
+    // Check for Docker
+    const dockerSpinner = ora('Checking Docker environment...').start();
+
+    try {
+      const { spawn } = require('child_process');
+
+      // Check Docker installation
+      const checkDocker = () => {
+        return new Promise((resolve) => {
+          const check = spawn('docker', ['--version'], { stdio: 'pipe' });
+          check.on('close', (code) => resolve(code === 0));
+          check.on('error', () => resolve(false));
+        });
+      };
+
+      const dockerAvailable = await checkDocker();
+      if (!dockerAvailable) {
+        dockerSpinner.fail('Docker not found');
+        console.log(chalk.red('❌ Docker is required for Docker sandbox'));
+        console.log(chalk.yellow('💡 Please install Docker and try again'));
+        console.log(chalk.blue('   Visit: https://docs.docker.com/get-docker/'));
+        return;
+      }
+
+      // Check Docker daemon
+      const checkDockerRunning = () => {
+        return new Promise((resolve) => {
+          const check = spawn('docker', ['ps'], { stdio: 'pipe' });
+          check.on('close', (code) => resolve(code === 0));
+          check.on('error', () => resolve(false));
+        });
+      };
+
+      const dockerRunning = await checkDockerRunning();
+      if (!dockerRunning) {
+        dockerSpinner.fail('Docker daemon not running');
+        console.log(chalk.red('❌ Docker daemon is not running'));
+        console.log(chalk.yellow('💡 Please start Docker and try again'));
+        return;
+      }
+
+      dockerSpinner.succeed('Docker environment ready');
+
+      // Build components string for installation inside sandbox
+      let componentsToInstall = '';
+      if (agent) {
+        const agentList = agent.split(',').map(a => `--agent ${a.trim()}`);
+        componentsToInstall += agentList.join(' ');
+      }
+      if (command) {
+        const commandList = command.split(',').map(c => ` --command ${c.trim()}`);
+        componentsToInstall += commandList.join(' ');
+      }
+      if (mcp) {
+        const mcpList = mcp.split(',').map(m => ` --mcp ${m.trim()}`);
+        componentsToInstall += mcpList.join(' ');
+      }
+      if (setting) {
+        const settingList = setting.split(',').map(s => ` --setting ${s.trim()}`);
+        componentsToInstall += settingList.join(' ');
+      }
+      if (hook) {
+        const hookList = hook.split(',').map(h => ` --hook ${h.trim()}`);
+        componentsToInstall += hookList.join(' ');
+      }
+
+      // Execute Docker launcher
+      const execSpinner = ora('Executing Docker sandbox...').start();
+
+      const launcherPath = path.join(sandboxDir, 'docker-launcher.js');
+
+      const dockerExec = spawn('node', [launcherPath, prompt, componentsToInstall.trim()], {
+        cwd: sandboxDir,
+        stdio: 'inherit',
+        env: {
+          ...process.env,
+          ANTHROPIC_API_KEY: anthropicKey
+        }
+      });
+
+      await new Promise((resolve, reject) => {
+        dockerExec.on('close', (dockerCode) => {
+          if (dockerCode === 0) {
+            execSpinner.succeed('Docker sandbox execution completed successfully');
+            console.log(chalk.green('\n✅ Docker sandbox execution finished!'));
+            console.log(chalk.white('📁 Output files are in the output/ directory'));
+            resolve();
+          } else {
+            execSpinner.fail(`Docker sandbox execution failed with code ${dockerCode}`);
+            reject(new Error(`Docker execution failed with code ${dockerCode}`));
+          }
+        });
+
+        dockerExec.on('error', (error) => {
+          execSpinner.fail('Failed to execute Docker sandbox');
+          reject(error);
+        });
+      });
+
+    } catch (error) {
+      dockerSpinner.fail('Failed to check Docker environment');
+      console.log(chalk.red(`❌ Error: ${error.message}`));
+      throw error;
+    }
+
+  } catch (error) {
+    console.log(chalk.red(`❌ Error setting up Docker sandbox: ${error.message}`));
+    console.log(chalk.yellow('💡 Please check your Docker installation and try again'));
+  }
+}
+
 async function executeE2BSandbox(options, targetDir) {
   const { agent, prompt, command, mcp, setting, hook, e2bKey, anthropicKey } = options;