@stackmemoryai/stackmemory 0.5.59 → 0.5.62

package/README.md

@@ -1,6 +1,6 @@
 # StackMemory
 
-**Lossless, project-scoped memory for AI tools** • v0.5.51
+**Lossless, project-scoped memory for AI tools** • v0.5.59
 
 StackMemory is a **production-ready memory runtime** for AI coding tools that preserves full project context across sessions:
 
@@ -36,6 +36,110 @@ StackMemory solves this by:
 
 ---
 
+## Features
+
+StackMemory includes powerful features to enhance your AI coding workflow. Enable/disable with `claude-sm config setup`.
+
+### Predictive Edit
+
+Anticipates your next edit and displays suggestions as a status bar overlay. Powered by llama-server and Claude Code's PostToolUse hooks.
+
+```bash
+claude-sm --sweep          # Enable (default: on)
+claude-sm --no-sweep       # Disable
+```
+
+- **How it works**: Analyzes tool outputs and predicts likely follow-up edits
+- **Interface**: Tab to accept, Esc to dismiss
+- **Requirement**: Installs `node-pty` on first use
+
+### Code Review
+
+AI-powered code review using Greptile's codebase-aware analysis. Automatically registers the Greptile MCP server for deep repository understanding.
+
+```bash
+claude-sm --greptile       # Enable (default: on)
+claude-sm --no-greptile    # Disable
+```
+
+- **Tools provided**: `index_repository`, `query_repository`, `get_repository_info`
+- **Requirement**: `GREPTILE_API_KEY` in `.env`
+
+### Prompt Forge
+
+Genetic Eval-driven Prompt Algorithm (GEPA) for automatic system prompt optimization. Evolves your `CLAUDE.md` through mutation, evaluation, and selection.
+
+```bash
+claude-sm --gepa           # Enable
+claude-sm --no-gepa        # Disable (default)
+```
+
+- **Auto-optimize**: Watches `CLAUDE.md` and runs optimization on changes
+- **Strategies**: rephrase, add_examples, remove_redundancy, restructure, add_constraints, simplify
+- **Output**: Before/after comparison with metrics (lines, tokens, rules)
+
+### Model Switcher
+
+Dynamic model routing based on task complexity. Automatically selects the optimal model (Haiku/Sonnet/Opus) for each request.
+
+```bash
+claude-sm --model-routing  # Enable
+claude-sm --no-model-routing  # Disable (default)
+```
+
+- **Cost optimization**: Uses cheaper models for simple tasks
+- **Quality preservation**: Routes complex tasks to more capable models
+
+### Safe Branch
+
+Git worktree isolation for experimental changes. Each session operates in an isolated branch, preventing accidental commits to main.
+
+```bash
+claude-sm --worktree       # Enable
+claude-sm --no-worktree    # Disable (default)
+```
+
+- **Isolation**: Changes happen in a separate worktree
+- **Safety**: Main branch remains untouched until explicit merge
+
+### Mobile Sync
+
+WhatsApp notifications for session updates and task completion. Stay informed even when away from your terminal.
+
+```bash
+claude-sm --whatsapp       # Enable
+claude-sm --no-whatsapp    # Disable (default)
+```
+
+- **Notifications**: Session start, task completion, errors
+- **Interactive**: Reply to trigger actions remotely
+
+### Session Insights
+
+Detailed tracing of session activity for debugging and optimization. Tracks tool calls, timing, and decision paths.
+
+```bash
+claude-sm --tracing        # Enable
+claude-sm --no-tracing     # Disable (default)
+```
+
+- **Visibility**: Full execution trace
+- **Analytics**: Performance metrics and patterns
+
+### Task Alert
+
+Desktop/terminal notifications when long-running tasks complete. Never miss a completed build or test run.
+
+```bash
+claude-sm --notify-on-done # Enable (default: on)
+claude-sm --no-notify-on-done  # Disable
+```
+
+- **Platforms**: macOS notifications, terminal bell
+- **Smart**: Only notifies for tasks taking >10 seconds
+
+---
+
 ## Core concepts (quick mental model)
 
 | Concept        | Meaning                                           |

package/dist/scripts/initialize.js

@@ -13,6 +13,7 @@ import {
 import { join } from "path";
 import { execSync } from "child_process";
 import chalk from "chalk";
+const enableDiffMem = process.argv.includes("--with-diffmem");
 function getEnv(key, defaultValue) {
   const value = process.env[key];
   if (value === void 0) {
@@ -102,15 +103,81 @@ try {
 } catch {
   console.log(chalk.yellow("\u26A0") + " Build failed - run npm run build manually");
 }
+if (enableDiffMem) {
+  console.log(chalk.blue("\n\u{1F9E0} Setting up DiffMem integration...\n"));
+  const diffmemDir = join(stackDir, "diffmem");
+  const diffmemStorageDir = join(diffmemDir, "storage");
+  const diffmemWorktreesDir = join(diffmemDir, "worktrees");
+  mkdirSync(diffmemStorageDir, { recursive: true });
+  mkdirSync(diffmemWorktreesDir, { recursive: true });
+  if (!existsSync(join(diffmemStorageDir, ".git"))) {
+    try {
+      execSync("git init", { cwd: diffmemStorageDir, stdio: "pipe" });
+      execSync('git commit --allow-empty -m "Initialize DiffMem storage"', {
+        cwd: diffmemStorageDir,
+        stdio: "pipe"
+      });
+      console.log(chalk.green("\u2713") + " Initialized DiffMem storage repository");
+    } catch {
+      console.log(
+        chalk.yellow("\u26A0") + " Failed to initialize git repo for DiffMem"
+      );
+    }
+  }
+  const diffmemConfigPath = join(diffmemDir, "config.json");
+  const diffmemConfig = {
+    enabled: true,
+    endpoint: "http://localhost:8000",
+    userId: process.env["USER"] || "default",
+    storagePath: diffmemStorageDir,
+    worktreePath: diffmemWorktreesDir
+  };
+  writeFileSync(diffmemConfigPath, JSON.stringify(diffmemConfig, null, 2));
+  console.log(chalk.green("\u2713") + " Created DiffMem configuration");
+  const envPath = join(projectRoot, ".env");
+  const diffmemEnvVars = `
+# DiffMem Configuration (Long-term User Memory)
+DIFFMEM_ENABLED=true
+DIFFMEM_ENDPOINT=http://localhost:8000
+DIFFMEM_USER_ID=${process.env["USER"] || "default"}
+DIFFMEM_STORAGE_PATH=${diffmemStorageDir}
+DIFFMEM_WORKTREE_PATH=${diffmemWorktreesDir}
+`;
+  if (existsSync(envPath)) {
+    const envContent = readFileSync(envPath, "utf-8");
+    if (!envContent.includes("DIFFMEM_")) {
+      appendFileSync(envPath, diffmemEnvVars);
+      console.log(chalk.green("\u2713") + " Added DiffMem configuration to .env");
+    }
+  } else {
+    writeFileSync(envPath, diffmemEnvVars.trim() + "\n");
+    console.log(chalk.green("\u2713") + " Created .env with DiffMem configuration");
+  }
+  console.log(chalk.green("\u2713") + " DiffMem integration configured");
+  console.log(
+    chalk.gray(
+      "  Note: DiffMem server must be running for user memory features"
+    )
+  );
+}
 console.log(chalk.green.bold("\n\u2705 StackMemory initialized successfully!\n"));
 console.log(chalk.gray("Next steps:"));
 console.log(chalk.gray("1. Add the MCP configuration above to Claude Code"));
 console.log(chalk.gray("2. Restart Claude Code"));
 console.log(chalk.gray("3. Start using context tracking!"));
+if (enableDiffMem) {
+  console.log(chalk.gray("4. Start DiffMem server: npm run diffmem:start"));
+}
 console.log(chalk.gray("\nUseful commands:"));
 console.log(
   chalk.cyan("  npm run mcp:dev") + " - Start MCP server in dev mode"
 );
 console.log(chalk.cyan("  npm run status") + " - Check StackMemory status");
-console.log(chalk.cyan("  npm run analyze") + " - Analyze context usage\n");
+console.log(chalk.cyan("  npm run analyze") + " - Analyze context usage");
+if (enableDiffMem) {
+  console.log(
+    chalk.cyan("  npm run diffmem:start") + " - Start DiffMem server"
+  );
+}
+console.log();
 //# sourceMappingURL=initialize.js.map

package/dist/scripts/initialize.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../scripts/initialize.ts"],
-  "sourcesContent": ["#!/usr/bin/env tsx\n/**\n * Initialize StackMemory in the current project\n */\n\nimport {\n  existsSync,\n  mkdirSync,\n  writeFileSync,\n  readFileSync,\n  appendFileSync,\n} from 'fs';\nimport { join } from 'path';\nimport { execSync } from 'child_process';\nimport chalk from 'chalk';\n// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new Error(`Environment variable ${key} is required`);\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\n\nconst projectRoot = process.cwd();\n\nconsole.log(chalk.blue.bold('\\n\uD83D\uDE80 Initializing StackMemory...\\n'));\n\n// 1. Create .stackmemory directory\nconst stackDir = join(projectRoot, '.stackmemory');\nif (!existsSync(stackDir)) {\n  mkdirSync(stackDir, { recursive: true });\n  console.log(chalk.green('\u2713') + ' Created .stackmemory directory');\n} else {\n  console.log(chalk.yellow('\u26A0') + ' .stackmemory directory already exists');\n}\n\n// 2. Add to .gitignore\nconst gitignorePath = join(projectRoot, '.gitignore');\nconst gitignoreEntry =\n  '\\n# StackMemory\\n.stackmemory/*.db\\n.stackmemory/*.db-*\\n';\n\nif (existsSync(gitignorePath)) {\n  const gitignore = readFileSync(gitignorePath, 'utf-8');\n  if (!gitignore.includes('.stackmemory')) {\n    appendFileSync(gitignorePath, gitignoreEntry);\n    console.log(chalk.green('\u2713') + ' Added .stackmemory to .gitignore');\n  }\n} else {\n  writeFileSync(gitignorePath, gitignoreEntry);\n  console.log(chalk.green('\u2713') + ' Created .gitignore with .stackmemory');\n}\n\n// 3. Create config file\nconst configPath = join(stackDir, 'config.json');\nif (!existsSync(configPath)) {\n  const config = {\n    projectId: projectRoot.split('/').pop(),\n    userId: process.env['USER'] || 'default',\n    teamId: 'local',\n    initialized: new Date().toISOString(),\n  };\n  writeFileSync(configPath, JSON.stringify(config, null, 2));\n  console.log(chalk.green('\u2713') + ' Created config file');\n}\n\n// 4. Create initial JSONL file\nconst jsonlPath = join(stackDir, 'frames.jsonl');\nif (!existsSync(jsonlPath)) {\n  const initialFrame = {\n    id: 'init_' + Date.now(),\n    type: 'system',\n    content: 'StackMemory initialized',\n    timestamp: Date.now(),\n  };\n  writeFileSync(jsonlPath, JSON.stringify(initialFrame) + '\\n');\n  console.log(chalk.green('\u2713') + ' Created frames.jsonl');\n}\n\n// 5. Create MCP config for Claude Code\nconst isMacOS = process.platform === 'darwin';\nconst mcpConfigPath = isMacOS\n  ? join(\n      process.env['HOME'] || '~',\n      'Library',\n      'Application Support',\n      'Claude',\n      'claude_desktop_config.json'\n    )\n  : join(\n      process.env['HOME'] || '~',\n      '.config',\n      'claude',\n      'claude_desktop_config.json'\n    );\nconsole.log(chalk.blue('\\n\uD83D\uDCDD MCP Configuration for Claude Code:\\n'));\n\nconst mcpConfig = {\n  mcpServers: {\n    stackmemory: {\n      command: 'node',\n      args: [join(projectRoot, 'dist', 'integrations', 'mcp', 'server.js')],\n      env: {\n        PROJECT_ROOT: projectRoot,\n      },\n    },\n  },\n};\n\nconsole.log(chalk.gray('Add this to your Claude Code MCP configuration:'));\nconsole.log(chalk.gray('(' + mcpConfigPath + ')\\n'));\nconsole.log(chalk.cyan(JSON.stringify(mcpConfig, null, 2)));\n\n// 6. Build the project\nconsole.log(chalk.blue('\\n\uD83D\uDCE6 Building TypeScript files...\\n'));\ntry {\n  execSync('npm run build', { stdio: 'inherit', cwd: projectRoot });\n  console.log(chalk.green('\u2713') + ' Build completed');\n} catch {\n  console.log(chalk.yellow('\u26A0') + ' Build failed - run npm run build manually');\n}\n\nconsole.log(chalk.green.bold('\\n\u2705 StackMemory initialized successfully!\\n'));\nconsole.log(chalk.gray('Next steps:'));\nconsole.log(chalk.gray('1. Add the MCP configuration above to Claude Code'));\nconsole.log(chalk.gray('2. Restart Claude Code'));\nconsole.log(chalk.gray('3. Start using context tracking!'));\nconsole.log(chalk.gray('\\nUseful commands:'));\nconsole.log(\n  chalk.cyan('  npm run mcp:dev') + ' - Start MCP server in dev mode'\n);\nconsole.log(chalk.cyan('  npm run status') + ' - Check StackMemory status');\nconsole.log(chalk.cyan('  npm run analyze') + ' - Analyze context usage\\n');\n"],
-  "mappings": "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",
+  "sourcesContent": ["#!/usr/bin/env tsx\n/**\n * Initialize StackMemory in the current project\n */\n\nimport {\n  existsSync,\n  mkdirSync,\n  writeFileSync,\n  readFileSync,\n  appendFileSync,\n} from 'fs';\nimport { join } from 'path';\nimport { execSync } from 'child_process';\nimport chalk from 'chalk';\n\n// Parse CLI args for --with-diffmem flag\nconst enableDiffMem = process.argv.includes('--with-diffmem');\n// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new Error(`Environment variable ${key} is required`);\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\n\nconst projectRoot = process.cwd();\n\nconsole.log(chalk.blue.bold('\\n\uD83D\uDE80 Initializing StackMemory...\\n'));\n\n// 1. Create .stackmemory directory\nconst stackDir = join(projectRoot, '.stackmemory');\nif (!existsSync(stackDir)) {\n  mkdirSync(stackDir, { recursive: true });\n  console.log(chalk.green('\u2713') + ' Created .stackmemory directory');\n} else {\n  console.log(chalk.yellow('\u26A0') + ' .stackmemory directory already exists');\n}\n\n// 2. Add to .gitignore\nconst gitignorePath = join(projectRoot, '.gitignore');\nconst gitignoreEntry =\n  '\\n# StackMemory\\n.stackmemory/*.db\\n.stackmemory/*.db-*\\n';\n\nif (existsSync(gitignorePath)) {\n  const gitignore = readFileSync(gitignorePath, 'utf-8');\n  if (!gitignore.includes('.stackmemory')) {\n    appendFileSync(gitignorePath, gitignoreEntry);\n    console.log(chalk.green('\u2713') + ' Added .stackmemory to .gitignore');\n  }\n} else {\n  writeFileSync(gitignorePath, gitignoreEntry);\n  console.log(chalk.green('\u2713') + ' Created .gitignore with .stackmemory');\n}\n\n// 3. Create config file\nconst configPath = join(stackDir, 'config.json');\nif (!existsSync(configPath)) {\n  const config = {\n    projectId: projectRoot.split('/').pop(),\n    userId: process.env['USER'] || 'default',\n    teamId: 'local',\n    initialized: new Date().toISOString(),\n  };\n  writeFileSync(configPath, JSON.stringify(config, null, 2));\n  console.log(chalk.green('\u2713') + ' Created config file');\n}\n\n// 4. Create initial JSONL file\nconst jsonlPath = join(stackDir, 'frames.jsonl');\nif (!existsSync(jsonlPath)) {\n  const initialFrame = {\n    id: 'init_' + Date.now(),\n    type: 'system',\n    content: 'StackMemory initialized',\n    timestamp: Date.now(),\n  };\n  writeFileSync(jsonlPath, JSON.stringify(initialFrame) + '\\n');\n  console.log(chalk.green('\u2713') + ' Created frames.jsonl');\n}\n\n// 5. Create MCP config for Claude Code\nconst isMacOS = process.platform === 'darwin';\nconst mcpConfigPath = isMacOS\n  ? join(\n      process.env['HOME'] || '~',\n      'Library',\n      'Application Support',\n      'Claude',\n      'claude_desktop_config.json'\n    )\n  : join(\n      process.env['HOME'] || '~',\n      '.config',\n      'claude',\n      'claude_desktop_config.json'\n    );\nconsole.log(chalk.blue('\\n\uD83D\uDCDD MCP Configuration for Claude Code:\\n'));\n\nconst mcpConfig = {\n  mcpServers: {\n    stackmemory: {\n      command: 'node',\n      args: [join(projectRoot, 'dist', 'integrations', 'mcp', 'server.js')],\n      env: {\n        PROJECT_ROOT: projectRoot,\n      },\n    },\n  },\n};\n\nconsole.log(chalk.gray('Add this to your Claude Code MCP configuration:'));\nconsole.log(chalk.gray('(' + mcpConfigPath + ')\\n'));\nconsole.log(chalk.cyan(JSON.stringify(mcpConfig, null, 2)));\n\n// 6. Build the project\nconsole.log(chalk.blue('\\n\uD83D\uDCE6 Building TypeScript files...\\n'));\ntry {\n  execSync('npm run build', { stdio: 'inherit', cwd: projectRoot });\n  console.log(chalk.green('\u2713') + ' Build completed');\n} catch {\n  console.log(chalk.yellow('\u26A0') + ' Build failed - run npm run build manually');\n}\n\n// 7. Optional: Initialize DiffMem for long-term user memory\nif (enableDiffMem) {\n  console.log(chalk.blue('\\n\uD83E\uDDE0 Setting up DiffMem integration...\\n'));\n\n  const diffmemDir = join(stackDir, 'diffmem');\n  const diffmemStorageDir = join(diffmemDir, 'storage');\n  const diffmemWorktreesDir = join(diffmemDir, 'worktrees');\n\n  // Create DiffMem directories\n  mkdirSync(diffmemStorageDir, { recursive: true });\n  mkdirSync(diffmemWorktreesDir, { recursive: true });\n\n  // Initialize git repo for storage\n  if (!existsSync(join(diffmemStorageDir, '.git'))) {\n    try {\n      execSync('git init', { cwd: diffmemStorageDir, stdio: 'pipe' });\n      execSync('git commit --allow-empty -m \"Initialize DiffMem storage\"', {\n        cwd: diffmemStorageDir,\n        stdio: 'pipe',\n      });\n      console.log(chalk.green('\u2713') + ' Initialized DiffMem storage repository');\n    } catch {\n      console.log(\n        chalk.yellow('\u26A0') + ' Failed to initialize git repo for DiffMem'\n      );\n    }\n  }\n\n  // Create DiffMem config\n  const diffmemConfigPath = join(diffmemDir, 'config.json');\n  const diffmemConfig = {\n    enabled: true,\n    endpoint: 'http://localhost:8000',\n    userId: process.env['USER'] || 'default',\n    storagePath: diffmemStorageDir,\n    worktreePath: diffmemWorktreesDir,\n  };\n  writeFileSync(diffmemConfigPath, JSON.stringify(diffmemConfig, null, 2));\n  console.log(chalk.green('\u2713') + ' Created DiffMem configuration');\n\n  // Add DiffMem env vars to .env file\n  const envPath = join(projectRoot, '.env');\n  const diffmemEnvVars = `\n# DiffMem Configuration (Long-term User Memory)\nDIFFMEM_ENABLED=true\nDIFFMEM_ENDPOINT=http://localhost:8000\nDIFFMEM_USER_ID=${process.env['USER'] || 'default'}\nDIFFMEM_STORAGE_PATH=${diffmemStorageDir}\nDIFFMEM_WORKTREE_PATH=${diffmemWorktreesDir}\n`;\n\n  if (existsSync(envPath)) {\n    const envContent = readFileSync(envPath, 'utf-8');\n    if (!envContent.includes('DIFFMEM_')) {\n      appendFileSync(envPath, diffmemEnvVars);\n      console.log(chalk.green('\u2713') + ' Added DiffMem configuration to .env');\n    }\n  } else {\n    writeFileSync(envPath, diffmemEnvVars.trim() + '\\n');\n    console.log(chalk.green('\u2713') + ' Created .env with DiffMem configuration');\n  }\n\n  console.log(chalk.green('\u2713') + ' DiffMem integration configured');\n  console.log(\n    chalk.gray(\n      '  Note: DiffMem server must be running for user memory features'\n    )\n  );\n}\n\nconsole.log(chalk.green.bold('\\n\u2705 StackMemory initialized successfully!\\n'));\nconsole.log(chalk.gray('Next steps:'));\nconsole.log(chalk.gray('1. Add the MCP configuration above to Claude Code'));\nconsole.log(chalk.gray('2. Restart Claude Code'));\nconsole.log(chalk.gray('3. Start using context tracking!'));\nif (enableDiffMem) {\n  console.log(chalk.gray('4. Start DiffMem server: npm run diffmem:start'));\n}\nconsole.log(chalk.gray('\\nUseful commands:'));\nconsole.log(\n  chalk.cyan('  npm run mcp:dev') + ' - Start MCP server in dev mode'\n);\nconsole.log(chalk.cyan('  npm run status') + ' - Check StackMemory status');\nconsole.log(chalk.cyan('  npm run analyze') + ' - Analyze context usage');\nif (enableDiffMem) {\n  console.log(\n    chalk.cyan('  npm run diffmem:start') + ' - Start DiffMem server'\n  );\n}\nconsole.log();\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/src/cli/claude-sm.js

@@ -37,7 +37,8 @@ const DEFAULT_SM_CONFIG = {
   defaultWhatsApp: false,
   defaultModelRouting: false,
   defaultSweep: true,
-  defaultGreptile: true
+  defaultGreptile: true,
+  defaultGEPA: false
 };
 function getConfigPath() {
   return path.join(os.homedir(), ".stackmemory", "claude-sm.json");
@@ -84,7 +85,8 @@ class ClaudeSM {
       useModelRouting: this.smConfig.defaultModelRouting,
       useThinkingMode: false,
       useSweep: this.smConfig.defaultSweep,
-      useGreptile: this.smConfig.defaultGreptile
+      useGreptile: this.smConfig.defaultGreptile,
+      useGEPA: this.smConfig.defaultGEPA
     };
     this.stackmemoryPath = this.findStackMemory();
     this.worktreeScriptPath = path.join(
@@ -154,6 +156,67 @@ class ClaudeSM {
     }
     return null;
   }
+  gepaProcess = null;
+  startGEPAWatcher() {
+    const claudeMdPath = fs.existsSync(path.join(process.cwd(), "CLAUDE.md")) ? path.join(process.cwd(), "CLAUDE.md") : null;
+    if (!claudeMdPath) {
+      console.log(chalk.gray("   Prompt Forge: disabled (no CLAUDE.md found)"));
+      return;
+    }
+    const gepaPaths = [
+      // From dist/src/cli -> scripts/gepa (3 levels up)
+      path.join(__dirname, "../../../scripts/gepa/hooks/auto-optimize.js"),
+      // From src/cli -> scripts/gepa (2 levels up, for dev mode)
+      path.join(__dirname, "../../scripts/gepa/hooks/auto-optimize.js"),
+      // Global install location
+      path.join(
+        os.homedir(),
+        ".stackmemory",
+        "scripts",
+        "gepa",
+        "hooks",
+        "auto-optimize.js"
+      ),
+      // npm global install
+      path.join(
+        __dirname,
+        "..",
+        "..",
+        "scripts",
+        "gepa",
+        "hooks",
+        "auto-optimize.js"
+      )
+    ];
+    const gepaScript = gepaPaths.find((p) => fs.existsSync(p));
+    if (!gepaScript) {
+      console.log(chalk.gray("   Prompt Forge: disabled (scripts not found)"));
+      return;
+    }
+    this.gepaProcess = spawn("node", [gepaScript, "watch", claudeMdPath], {
+      detached: true,
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, GEPA_SILENT: "1" }
+    });
+    this.gepaProcess.unref();
+    this.gepaProcess.stdout?.on("data", (data) => {
+      const output = data.toString().trim();
+      if (output && !output.includes("Watching")) {
+        console.log(chalk.magenta(`[GEPA] ${output}`));
+      }
+    });
+    console.log(
+      chalk.cyan(
+        `   Prompt Forge: watching ${path.basename(claudeMdPath)} for optimization`
+      )
+    );
+  }
+  stopGEPAWatcher() {
+    if (this.gepaProcess) {
+      this.gepaProcess.kill("SIGTERM");
+      this.gepaProcess = null;
+    }
+  }
   ensureGreptileMcp() {
     const apiKey = process.env["GREPTILE_API_KEY"];
     const ghToken = process.env["GITHUB_TOKEN"];
@@ -582,6 +645,12 @@ class ClaudeSM {
         case "--no-greptile":
           this.config.useGreptile = false;
           break;
+        case "--gepa":
+          this.config.useGEPA = true;
+          break;
+        case "--no-gepa":
+          this.config.useGEPA = false;
+          break;
         default:
           claudeArgs.push(arg);
       }
@@ -727,6 +796,9 @@ class ClaudeSM {
     if (this.config.useGreptile) {
       this.ensureGreptileMcp();
     }
+    if (this.config.useGEPA) {
+      this.startGEPAWatcher();
+    }
     if (this.config.useWhatsApp) {
       console.log(
         chalk.cyan("\u{1F4F1} WhatsApp mode: notifications + webhook enabled")
@@ -817,6 +889,7 @@ class ClaudeSM {
       process.exit(1);
     });
     claude.on("exit", async (code) => {
+      this.stopGEPAWatcher();
       const status = fallbackMonitor.getStatus();
       if (status.inFallback) {
         console.log(
@@ -870,38 +943,24 @@ const configCmd = program.command("config").description("Manage claude-sm defaul
 configCmd.command("show").description("Show current default settings").action(() => {
   const config = loadSMConfig();
   console.log(chalk.blue("claude-sm defaults:"));
-  console.log(
-    `  defaultWorktree: ${config.defaultWorktree ? chalk.green("true") : chalk.gray("false")}`
-  );
-  console.log(
-    `  defaultSandbox:  ${config.defaultSandbox ? chalk.green("true") : chalk.gray("false")}`
-  );
-  console.log(
-    `  defaultChrome:   ${config.defaultChrome ? chalk.green("true") : chalk.gray("false")}`
-  );
-  console.log(
-    `  defaultTracing:  ${config.defaultTracing ? chalk.green("true") : chalk.gray("false")}`
-  );
-  console.log(
-    `  defaultRemote:   ${config.defaultRemote ? chalk.green("true") : chalk.gray("false")}`
-  );
-  console.log(
-    `  defaultNotifyOnDone: ${config.defaultNotifyOnDone ? chalk.green("true") : chalk.gray("false")}`
-  );
-  console.log(
-    `  defaultWhatsApp: ${config.defaultWhatsApp ? chalk.green("true") : chalk.gray("false")}`
-  );
-  console.log(
-    `  defaultModelRouting: ${config.defaultModelRouting ? chalk.green("true") : chalk.gray("false")}`
-  );
-  console.log(
-    `  defaultSweep:        ${config.defaultSweep ? chalk.green("true") : chalk.gray("false")}`
-  );
-  console.log(
-    `  defaultGreptile:     ${config.defaultGreptile ? chalk.green("true") : chalk.gray("false")}`
-  );
+  const on = chalk.green("ON ");
+  const off = chalk.gray("OFF");
+  console.log(chalk.cyan("\n  Feature           Status"));
+  console.log(chalk.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(`  Predictive Edit   ${config.defaultSweep ? on : off}`);
+  console.log(`  Code Review       ${config.defaultGreptile ? on : off}`);
+  console.log(`  Prompt Forge      ${config.defaultGEPA ? on : off}`);
+  console.log(`  Model Switcher    ${config.defaultModelRouting ? on : off}`);
+  console.log(`  Safe Branch       ${config.defaultWorktree ? on : off}`);
+  console.log(`  Mobile Sync       ${config.defaultWhatsApp ? on : off}`);
+  console.log(`  Session Insights  ${config.defaultTracing ? on : off}`);
+  console.log(`  Task Alert        ${config.defaultNotifyOnDone ? on : off}`);
+  console.log(chalk.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(`  Sandbox           ${config.defaultSandbox ? on : off}`);
+  console.log(`  Chrome            ${config.defaultChrome ? on : off}`);
+  console.log(`  Remote            ${config.defaultRemote ? on : off}`);
   console.log(chalk.gray(`
-Config: ${getConfigPath()}`));
+  Config: ${getConfigPath()}`));
 });
 configCmd.command("set <key> <value>").description("Set a default (e.g., set worktree true)").action((key, value) => {
   const config = loadSMConfig();
@@ -918,14 +977,15 @@ configCmd.command("set <key> <value>").description("Set a default (e.g., set wor
     "model-routing": "defaultModelRouting",
     modelrouting: "defaultModelRouting",
     sweep: "defaultSweep",
-    greptile: "defaultGreptile"
+    greptile: "defaultGreptile",
+    gepa: "defaultGEPA"
   };
   const configKey = keyMap[key];
   if (!configKey) {
     console.log(chalk.red(`Unknown key: ${key}`));
     console.log(
       chalk.gray(
-        "Valid keys: worktree, sandbox, chrome, tracing, remote, notify-done, whatsapp, sweep, greptile"
+        "Valid keys: worktree, sandbox, chrome, tracing, remote, notify-done, whatsapp, sweep, greptile, gepa"
       )
     );
     process.exit(1);
@@ -1016,6 +1076,21 @@ configCmd.command("greptile-off").description("Disable Greptile AI code review b
   saveSMConfig(config);
   console.log(chalk.green("Greptile disabled by default"));
 });
+configCmd.command("gepa-on").description("Enable GEPA auto-optimization of CLAUDE.md on changes").action(() => {
+  const config = loadSMConfig();
+  config.defaultGEPA = true;
+  saveSMConfig(config);
+  console.log(chalk.green("GEPA auto-optimization enabled by default"));
+  console.log(
+    chalk.gray("CLAUDE.md changes will trigger evolutionary optimization")
+  );
+});
+configCmd.command("gepa-off").description("Disable GEPA auto-optimization").action(() => {
+  const config = loadSMConfig();
+  config.defaultGEPA = false;
+  saveSMConfig(config);
+  console.log(chalk.green("GEPA auto-optimization disabled by default"));
+});
 configCmd.command("setup").description("Interactive feature setup wizard").action(async () => {
   const inquirer = await import("inquirer");
   const ora = (await import("ora")).default;
@@ -1024,38 +1099,43 @@ configCmd.command("setup").description("Interactive feature setup wizard").actio
   const features = [
     {
       key: "defaultSweep",
-      name: "Sweep",
-      desc: "Next-edit predictions via PTY wrapper (installs node-pty)"
+      name: "Predictive Edit",
+      desc: "AI-powered next-edit suggestions in real-time"
     },
     {
       key: "defaultGreptile",
-      name: "Greptile",
-      desc: "AI code review MCP server (requires GREPTILE_API_KEY)"
+      name: "Code Review",
+      desc: "Automated code review with deep codebase intelligence"
+    },
+    {
+      key: "defaultGEPA",
+      name: "Prompt Forge",
+      desc: "Evolutionary optimization of system prompts"
     },
     {
       key: "defaultModelRouting",
-      name: "Model Routing",
-      desc: "Route tasks to Qwen/other providers"
+      name: "Model Switcher",
+      desc: "Smart routing across Claude, Qwen, and other models"
     },
     {
       key: "defaultWorktree",
-      name: "Worktree",
-      desc: "Git worktree isolation per instance"
+      name: "Safe Branch",
+      desc: "Isolated git worktrees for conflict-free parallel work"
     },
     {
       key: "defaultWhatsApp",
-      name: "WhatsApp",
-      desc: "Notifications and remote control"
+      name: "Mobile Sync",
+      desc: "Remote control and notifications via WhatsApp"
     },
     {
       key: "defaultTracing",
-      name: "Tracing",
-      desc: "Debug trace logging"
+      name: "Session Insights",
+      desc: "Deep execution tracing and performance analytics"
     },
     {
       key: "defaultNotifyOnDone",
-      name: "Notify on Done",
-      desc: "Notification when session ends"
+      name: "Task Alert",
+      desc: "Instant notification when sessions complete"
     }
   ];
   const choices = features.map((f) => ({
@@ -1147,7 +1227,7 @@ Saved to ${getConfigPath()}`));
 program.option("-w, --worktree", "Create isolated worktree for this instance").option("-W, --no-worktree", "Disable worktree (override default)").option("-r, --remote", "Enable remote mode (WhatsApp for all questions)").option("--no-remote", "Disable remote mode (override default)").option("-n, --notify-done", "Send WhatsApp notification when session ends").option("--no-notify-done", "Disable notification when session ends").option(
   "--whatsapp",
   "Enable WhatsApp mode (auto-start webhook + ngrok + notifications)"
-).option("--no-whatsapp", "Disable WhatsApp mode (override default)").option("-s, --sandbox", "Enable sandbox mode (file/network restrictions)").option("-c, --chrome", "Enable Chrome automation").option("-a, --auto", "Automatically detect and apply best settings").option("-b, --branch <name>", "Specify branch name for worktree").option("-t, --task <desc>", "Task description for context").option("--claude-bin <path>", "Path to claude CLI (or use CLAUDE_BIN)").option("--no-context", "Disable StackMemory context integration").option("--no-trace", "Disable debug tracing (enabled by default)").option("--verbose-trace", "Enable verbose debug tracing with full details").option("--think", "Enable thinking mode with Qwen (deep reasoning)").option("--think-hard", "Alias for --think").option("--ultrathink", "Alias for --think").option("--qwen", "Force Qwen provider for this session").option("--openai", "Force OpenAI provider for this session").option("--ollama", "Force Ollama provider for this session").option("--model-routing", "Enable model routing").option("--no-model-routing", "Disable model routing").option("--sweep", "Enable Sweep next-edit predictions (PTY wrapper)").option("--no-sweep", "Disable Sweep predictions").option("--greptile", "Enable Greptile AI code review (MCP server)").option("--no-greptile", "Disable Greptile integration").helpOption("-h, --help", "Display help").allowUnknownOption(true).action(async (_options) => {
+).option("--no-whatsapp", "Disable WhatsApp mode (override default)").option("-s, --sandbox", "Enable sandbox mode (file/network restrictions)").option("-c, --chrome", "Enable Chrome automation").option("-a, --auto", "Automatically detect and apply best settings").option("-b, --branch <name>", "Specify branch name for worktree").option("-t, --task <desc>", "Task description for context").option("--claude-bin <path>", "Path to claude CLI (or use CLAUDE_BIN)").option("--no-context", "Disable StackMemory context integration").option("--no-trace", "Disable debug tracing (enabled by default)").option("--verbose-trace", "Enable verbose debug tracing with full details").option("--think", "Enable thinking mode with Qwen (deep reasoning)").option("--think-hard", "Alias for --think").option("--ultrathink", "Alias for --think").option("--qwen", "Force Qwen provider for this session").option("--openai", "Force OpenAI provider for this session").option("--ollama", "Force Ollama provider for this session").option("--model-routing", "Enable model routing").option("--no-model-routing", "Disable model routing").option("--sweep", "Enable Sweep next-edit predictions (PTY wrapper)").option("--no-sweep", "Disable Sweep predictions").option("--greptile", "Enable Greptile AI code review (MCP server)").option("--no-greptile", "Disable Greptile integration").option("--gepa", "Enable GEPA auto-optimization of CLAUDE.md").option("--no-gepa", "Disable GEPA auto-optimization").helpOption("-h, --help", "Display help").allowUnknownOption(true).action(async (_options) => {
   const claudeSM = new ClaudeSM();
   const args = process.argv.slice(2);
   await claudeSM.run(args);