claude-code-autoconfig 1.0.1 → 1.0.3

package/.claude/commands/autoconfig.md

@@ -171,6 +171,10 @@ This ensures double-clicking CLAUDE.md in the guide shows the real generated con
 
 ## After Completion
 
-Once autoconfig is complete, prompt the user:
+Once autoconfig is complete, open the interactive guide in the user's browser:
 
-**Run `/show-guide` for an interactive walkthrough of your new Claude Code project setup.**
+- macOS: `open .claude/guide/autoconfig.guide.html`
+- Linux: `xdg-open .claude/guide/autoconfig.guide.html`
+- Windows: `start .claude/guide/autoconfig.guide.html`
+
+This shows the user what got installed and how to use it.

package/bin/cli.js

@@ -2,19 +2,53 @@
 
 const fs = require('fs');
 const path = require('path');
-const { exec } = require('child_process');
+const { execSync, spawn } = require('child_process');
 
 const cwd = process.cwd();
 const packageDir = path.dirname(__dirname);
 
-console.log('\x1b[36m%s\x1b[0m', '🚀 Installing Claude Code Autoconfig...');
+console.log('\x1b[36m%s\x1b[0m', '🚀 Claude Code Autoconfig');
 console.log();
 
-// Files/dirs to skip during copy (project-specific, not for distribution)
-const SKIP_FILES = ['settings.local.json', 'retro'];
+// Step 1: Check if Claude Code is installed
+function isClaudeInstalled() {
+  try {
+    execSync('claude --version', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
 
-// Helper to copy directory recursively
-function copyDir(src, dest) {
+function installClaude() {
+  console.log('\x1b[33m%s\x1b[0m', '⚠️  Claude Code not found. Installing...');
+  console.log();
+  try {
+    execSync('npm install -g @anthropic-ai/claude-code', { stdio: 'inherit' });
+    console.log();
+    console.log('\x1b[32m%s\x1b[0m', '✅ Claude Code installed');
+    return true;
+  } catch (err) {
+    console.log('\x1b[31m%s\x1b[0m', '❌ Failed to install Claude Code');
+    console.log('   Install manually: npm install -g @anthropic-ai/claude-code');
+    return false;
+  }
+}
+
+if (!isClaudeInstalled()) {
+  if (!installClaude()) {
+    process.exit(1);
+  }
+}
+
+console.log('\x1b[32m%s\x1b[0m', '✅ Claude Code detected');
+
+// Step 2: Backup existing .claude/ if present
+const claudeDest = path.join(cwd, '.claude');
+const SKIP_FILES = ['settings.local.json', 'retro', 'migration'];
+let migrationPath = null;
+
+function copyDirForBackup(src, dest) {
   fs.mkdirSync(dest, { recursive: true });
   const entries = fs.readdirSync(src, { withFileTypes: true });
 
@@ -25,20 +59,92 @@ function copyDir(src, dest) {
     const destPath = path.join(dest, entry.name);
 
     if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
+      copyDirForBackup(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+if (fs.existsSync(claudeDest)) {
+  // Create timestamped backup
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+  const migrationDir = path.join(claudeDest, 'migration');
+  migrationPath = path.join(migrationDir, timestamp);
+
+  fs.mkdirSync(migrationPath, { recursive: true });
+
+  // Copy existing files to backup (excluding migration folder itself)
+  const entries = fs.readdirSync(claudeDest, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name === 'migration') continue;
+
+    const srcPath = path.join(claudeDest, entry.name);
+    const destPath = path.join(migrationPath, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirForBackup(srcPath, destPath);
     } else {
       fs.copyFileSync(srcPath, destPath);
     }
   }
+
+  // Create/update migration README
+  const readmePath = path.join(migrationDir, 'README.md');
+  const readmeContent = `# Migration Backups
+
+This folder contains backups of previous .claude/ configurations created during autoconfig upgrades.
+
+Each timestamped folder contains the files that existed before that migration.
+
+## Backups
+
+- \`${timestamp}/\` - Backup created during autoconfig install
+
+## Restoring
+
+To restore a previous configuration, copy files from the backup folder back to \`.claude/\`.
+`;
+
+  // Append to existing README or create new
+  if (fs.existsSync(readmePath)) {
+    const existing = fs.readFileSync(readmePath, 'utf8');
+    const newEntry = `- \`${timestamp}/\` - Backup created during autoconfig install\n`;
+    if (!existing.includes(timestamp)) {
+      const updated = existing.replace('## Backups\n\n', `## Backups\n\n${newEntry}`);
+      fs.writeFileSync(readmePath, updated);
+    }
+  } else {
+    fs.writeFileSync(readmePath, readmeContent);
+  }
+
+  console.log('\x1b[33m%s\x1b[0m', `⚠️  Existing .claude/ backed up to migration/${timestamp}/`);
 }
 
-// Copy .claude directory
+// Step 3: Copy new files
 const claudeSrc = path.join(packageDir, '.claude');
-const claudeDest = path.join(cwd, '.claude');
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (SKIP_FILES.includes(entry.name)) continue;
+
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
 
 if (fs.existsSync(claudeSrc)) {
   copyDir(claudeSrc, claudeDest);
-  console.log('\x1b[32m%s\x1b[0m', '✅ Created .claude/ directory structure');
+  console.log('\x1b[32m%s\x1b[0m', '✅ Created .claude/ directory');
 } else {
   console.log('\x1b[31m%s\x1b[0m', '❌ Error: .claude directory not found in package');
   process.exit(1);
@@ -49,29 +155,31 @@ const claudeMdSrc = path.join(packageDir, 'CLAUDE.md');
 const claudeMdDest = path.join(cwd, 'CLAUDE.md');
 
 if (fs.existsSync(claudeMdDest)) {
-  console.log('\x1b[33m%s\x1b[0m', '⚠️  CLAUDE.md already exists, saving template as CLAUDE.md.template');
+  // Backup existing CLAUDE.md to migration folder if we have one
+  if (migrationPath) {
+    fs.copyFileSync(claudeMdDest, path.join(migrationPath, 'CLAUDE.md'));
+  }
+  console.log('\x1b[33m%s\x1b[0m', '⚠️  CLAUDE.md exists, saved template as CLAUDE.md.template');
   fs.copyFileSync(claudeMdSrc, path.join(cwd, 'CLAUDE.md.template'));
 } else if (fs.existsSync(claudeMdSrc)) {
   fs.copyFileSync(claudeMdSrc, claudeMdDest);
   console.log('\x1b[32m%s\x1b[0m', '✅ Created CLAUDE.md');
 }
 
+// Step 4: Launch Claude Code
 console.log();
-console.log('\x1b[36m%s\x1b[0m', '✨ Claude Code Autoconfig installed!');
-console.log();
-console.log('Once Claude Code is open:');
-console.log('  Run \x1b[33m/autoconfig\x1b[0m to configure for your project');
+console.log('\x1b[36m%s\x1b[0m', '🚀 Launching Claude Code...');
+console.log('\x1b[33m%s\x1b[0m', '   Run /autoconfig to complete setup');
 console.log();
 
-// Auto-open the guide in browser
-const guidePath = path.join(cwd, '.claude', 'guide', 'autoconfig.guide.html');
-if (fs.existsSync(guidePath)) {
-  console.log('\x1b[36m%s\x1b[0m', '📖 Opening interactive guide...');
-  const openCmd = process.platform === 'win32' ? 'start ""' :
-                  process.platform === 'darwin' ? 'open' : 'xdg-open';
-  exec(`${openCmd} "${guidePath}"`, (err) => {
-    if (err) {
-      console.log('\x1b[33m%s\x1b[0m', `   Run /show-guide in Claude Code to view the guide`);
-    }
-  });
-}
+// Spawn claude in the current directory, inheriting stdio for interactive use
+const claude = spawn('claude', [], {
+  cwd: cwd,
+  stdio: 'inherit',
+  shell: true
+});
+
+claude.on('error', (err) => {
+  console.log('\x1b[31m%s\x1b[0m', '❌ Failed to launch Claude Code');
+  console.log('   Run "claude" manually, then run /autoconfig');
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-autoconfig",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Intelligent, self-configuring setup for Claude Code. One command analyzes your project, configures Claude, and shows you what it did.",
   "author": "ADAC 1001 <info@adac1001.com>",
   "license": "MIT",