@stackmemoryai/stackmemory 1.5.5 → 1.5.7

package/bin/gemini-sm

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Gemini-SM CLI Launcher (ESM)
+ * Delegates to built CLI in dist without requiring tsx.
+ */
+import('../dist/src/cli/gemini-sm.js');

package/dist/src/cli/commands/orchestrate.js

@@ -464,6 +464,305 @@ function createConductorCommands() {
     });
     await conductor.start();
   });
+  cmd.command("monitor").description("Interactive TUI dashboard for conductor monitoring").option("--interval <seconds>", "Auto-refresh interval in seconds", "10").option(
+    "--phase <phase>",
+    "Filter by phase (reading, planning, implementing, testing, committing)"
+  ).option("--no-interactive", "Disable interactive keys (CI/pipe mode)").action(async (options) => {
+    const interval = parseInt(options.interval, 10) * 1e3;
+    const interactive = options.interactive !== false;
+    let currentMode = "dashboard";
+    let paused = false;
+    let refreshInterval = interval;
+    let phaseFilter = options.phase || null;
+    const b = "\x1B[1m";
+    const d = "\x1B[2m";
+    const cyan = "\x1B[36m";
+    const green = "\x1B[32m";
+    const yellow = "\x1B[33m";
+    const red = "\x1B[31m";
+    const r = "\x1B[0m";
+    function readStatuses() {
+      const agentsDir = join(
+        homedir(),
+        ".stackmemory",
+        "conductor",
+        "agents"
+      );
+      if (!existsSync(agentsDir)) return [];
+      const entries = readdirSync(agentsDir, { withFileTypes: true });
+      const statuses = [];
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const statusPath = join(agentsDir, entry.name, "status.json");
+        if (!existsSync(statusPath)) continue;
+        try {
+          statuses.push(JSON.parse(readFileSync(statusPath, "utf-8")));
+        } catch {
+        }
+      }
+      statuses.sort(
+        (a, b2) => new Date(b2.lastUpdate).getTime() - new Date(a.lastUpdate).getTime()
+      );
+      if (phaseFilter) {
+        return statuses.filter((s) => s.phase === phaseFilter);
+      }
+      return statuses;
+    }
+    function printStatusTable(statuses) {
+      if (statuses.length === 0) {
+        const filterNote = phaseFilter ? ` (filter: ${phaseFilter})` : "";
+        console.log(`  No active agents${filterNote}`);
+        return;
+      }
+      const header = `${"Issue".padEnd(12)}${"Phase".padEnd(16)}${"Tools".padStart(7)}${"Files".padStart(7)}${"Tokens".padStart(9)}   Last Update`;
+      console.log(header);
+      for (const s of statuses) {
+        const elapsed = Date.now() - new Date(s.lastUpdate).getTime();
+        const line = `${s.issue.padEnd(12)}${s.phase.padEnd(16)}${String(s.toolCalls).padStart(7)}${String(s.filesModified).padStart(7)}${String(s.tokensUsed).padStart(9)}   ${formatElapsed(elapsed)}`;
+        console.log(line);
+      }
+    }
+    function getWorktreeFiles(workspacePath) {
+      if (!workspacePath || !existsSync(workspacePath)) return [];
+      try {
+        const output = execSync("git status --short 2>/dev/null", {
+          cwd: workspacePath,
+          timeout: 5e3,
+          encoding: "utf-8"
+        });
+        return output.trim().split("\n").filter((l) => l.length > 0);
+      } catch {
+        return [];
+      }
+    }
+    function printFilesView(statuses) {
+      if (statuses.length === 0) {
+        const filterNote = phaseFilter ? ` (filter: ${phaseFilter})` : "";
+        console.log(`  No active agents${filterNote}`);
+        return;
+      }
+      for (const s of statuses) {
+        const elapsed = Date.now() - new Date(s.lastUpdate).getTime();
+        const phaseColor = s.phase === "committing" ? green : s.phase === "testing" ? yellow : s.phase === "implementing" ? cyan : "";
+        console.log(
+          `${b}${s.issue}${r}  ${phaseColor}${s.phase}${r}  ${d}${formatElapsed(elapsed)}${r}`
+        );
+        const files = getWorktreeFiles(s.workspacePath || "");
+        if (files.length === 0) {
+          console.log(`  ${d}(no file changes detected)${r}`);
+        } else {
+          for (const f of files) {
+            const status = f.substring(0, 2);
+            const path = f.substring(3);
+            let color = "";
+            if (status.includes("M")) color = yellow;
+            else if (status.includes("A") || status.includes("?"))
+              color = green;
+            else if (status.includes("D")) color = red;
+            console.log(`  ${color}${status}${r} ${path}`);
+          }
+        }
+        console.log("");
+      }
+    }
+    async function getUsage() {
+      const conductor = new Conductor({ repoRoot: process.cwd() });
+      await conductor.scanUsageLogs();
+      return conductor.getUsageSummary();
+    }
+    async function render() {
+      process.stdout.write("\x1B[2J\x1B[H");
+      const pauseTag = paused ? " [PAUSED]" : "";
+      const intervalSec = Math.round(refreshInterval / 1e3);
+      console.log(
+        `${b}\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550${r}`
+      );
+      console.log(
+        `${b}  Conductor Monitor${r}  ${(/* @__PURE__ */ new Date()).toLocaleTimeString()}${pauseTag}`
+      );
+      console.log(
+        `  Mode: ${cyan}${currentMode}${r}  |  Refresh: ${intervalSec}s`
+      );
+      const filterNote = phaseFilter ? `  Filter: ${cyan}${phaseFilter}${r}` : "";
+      if (interactive) {
+        console.log(
+          `  ${d}[s]tatus [u]sage [f]iles [d]ashboard [j]son [l]ogs [r]efresh [p]ause [1-5]phase [0]clear [+/-] [q]uit${r}`
+        );
+      }
+      if (filterNote) console.log(filterNote);
+      console.log(
+        `${b}\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550${r}`
+      );
+      console.log("");
+      const statuses = readStatuses();
+      switch (currentMode) {
+        case "dashboard": {
+          printStatusTable(statuses);
+          console.log("");
+          const usage = await getUsage();
+          printUsageSummary(usage);
+          break;
+        }
+        case "status":
+          printStatusTable(statuses);
+          break;
+        case "usage": {
+          const usage = await getUsage();
+          printUsageSummary(usage);
+          break;
+        }
+        case "json": {
+          const usage = await getUsage();
+          console.log(JSON.stringify(usage, null, 2));
+          break;
+        }
+        case "files":
+          printFilesView(statuses);
+          break;
+      }
+      console.log("");
+      console.log(
+        `${d}\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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${r}`
+      );
+    }
+    await render();
+    if (!interactive) {
+      const timer = setInterval(async () => {
+        if (!paused) await render();
+      }, refreshInterval);
+      await new Promise((resolve) => {
+        process.on("SIGINT", () => {
+          clearInterval(timer);
+          resolve();
+        });
+        process.on("SIGTERM", () => {
+          clearInterval(timer);
+          resolve();
+        });
+      });
+      return;
+    }
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+    }
+    process.stdin.resume();
+    process.stdin.setEncoding("utf-8");
+    let refreshTimer = null;
+    function scheduleRefresh() {
+      if (refreshTimer) clearTimeout(refreshTimer);
+      refreshTimer = setTimeout(async () => {
+        if (!paused) await render();
+        scheduleRefresh();
+      }, refreshInterval);
+    }
+    scheduleRefresh();
+    process.stdin.on("data", async (key) => {
+      switch (key) {
+        case "s":
+          currentMode = "status";
+          await render();
+          break;
+        case "u":
+          currentMode = "usage";
+          await render();
+          break;
+        case "d":
+          currentMode = "dashboard";
+          await render();
+          break;
+        case "f":
+          currentMode = "files";
+          await render();
+          break;
+        case "j":
+          currentMode = "json";
+          await render();
+          break;
+        case "1":
+          phaseFilter = "reading";
+          await render();
+          break;
+        case "2":
+          phaseFilter = "planning";
+          await render();
+          break;
+        case "3":
+          phaseFilter = "implementing";
+          await render();
+          break;
+        case "4":
+          phaseFilter = "testing";
+          await render();
+          break;
+        case "5":
+          phaseFilter = "committing";
+          await render();
+          break;
+        case "0":
+          phaseFilter = null;
+          await render();
+          break;
+        case "l": {
+          process.stdout.write("\x1B[2J\x1B[H");
+          const statuses = readStatuses();
+          if (statuses.length === 0) {
+            console.log("No active agents to show logs for.");
+          } else {
+            console.log("Active issues:");
+            console.log("");
+            for (const s of statuses) {
+              console.log(`  ${s.issue}  (${s.phase})`);
+            }
+            console.log("");
+            console.log("Use: stackmemory conductor logs <ISSUE-ID> -f");
+          }
+          console.log("\nPress any key to return...");
+          await new Promise((resolve) => {
+            process.stdin.once("data", () => resolve());
+          });
+          await render();
+          break;
+        }
+        case "r":
+          await render();
+          break;
+        case "p":
+          paused = !paused;
+          await render();
+          break;
+        case "+":
+        case "=":
+          refreshInterval += 5e3;
+          await render();
+          scheduleRefresh();
+          break;
+        case "-":
+        case "_":
+          if (refreshInterval > 5e3) refreshInterval -= 5e3;
+          await render();
+          scheduleRefresh();
+          break;
+        case "q":
+        case "":
+          if (refreshTimer) clearTimeout(refreshTimer);
+          if (process.stdin.isTTY) process.stdin.setRawMode(false);
+          process.exit(0);
+          break;
+      }
+    });
+    await new Promise((resolve) => {
+      process.on("SIGINT", () => {
+        if (refreshTimer) clearTimeout(refreshTimer);
+        if (process.stdin.isTTY) process.stdin.setRawMode(false);
+        resolve();
+      });
+      process.on("SIGTERM", () => {
+        if (refreshTimer) clearTimeout(refreshTimer);
+        if (process.stdin.isTTY) process.stdin.setRawMode(false);
+        resolve();
+      });
+    });
+  });
   return cmd;
 }
 export {

package/dist/src/cli/commands/orchestrator.js

@@ -406,7 +406,8 @@ class Conductor {
         phase: run.phase,
         filesModified: run.filesModified,
         toolCalls: run.toolCalls,
-        tokensUsed: run.tokensUsed
+        tokensUsed: run.tokensUsed,
+        workspacePath: run.workspacePath || void 0
       };
       writeFileSync(join(dir, "status.json"), JSON.stringify(status, null, 2));
     } catch {

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

@@ -0,0 +1,481 @@
+#!/usr/bin/env node
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { config as loadDotenv } from "dotenv";
+loadDotenv({ override: true, debug: false });
+import { spawn, execSync, execFileSync } from "child_process";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import { program } from "commander";
+import { v4 as uuidv4 } from "uuid";
+import chalk from "chalk";
+import { initializeTracing, trace } from "../core/trace/index.js";
+const DEFAULT_SM_CONFIG = {
+  defaultWorktree: false,
+  defaultTracing: true
+};
+function getConfigPath() {
+  return path.join(os.homedir(), ".stackmemory", "gemini-sm.json");
+}
+function loadSMConfig() {
+  try {
+    const configPath = getConfigPath();
+    if (fs.existsSync(configPath)) {
+      const content = fs.readFileSync(configPath, "utf8");
+      return { ...DEFAULT_SM_CONFIG, ...JSON.parse(content) };
+    }
+  } catch {
+  }
+  return { ...DEFAULT_SM_CONFIG };
+}
+function saveSMConfig(config) {
+  const configPath = getConfigPath();
+  const dir = path.dirname(configPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+}
+class GeminiSM {
+  config;
+  stackmemoryPath;
+  smConfig;
+  constructor() {
+    this.smConfig = loadSMConfig();
+    this.config = {
+      instanceId: this.generateInstanceId(),
+      useWorktree: this.smConfig.defaultWorktree,
+      contextEnabled: true,
+      tracingEnabled: this.smConfig.defaultTracing,
+      verboseTracing: false,
+      sessionStartTime: Date.now()
+    };
+    this.stackmemoryPath = this.findStackMemory();
+  }
+  getRepoRoot() {
+    try {
+      const root = execSync("git rev-parse --show-toplevel", {
+        encoding: "utf8"
+      }).trim();
+      return root || null;
+    } catch {
+      return null;
+    }
+  }
+  ensureInitialized() {
+    try {
+      const root = this.getRepoRoot();
+      const dir = root || process.cwd();
+      const dbPath = path.join(dir, ".stackmemory", "context.db");
+      if (!fs.existsSync(dbPath)) {
+        console.log(chalk.blue("Initializing StackMemory for this project..."));
+        execSync(`${this.stackmemoryPath} init`, {
+          cwd: dir,
+          stdio: ["ignore", "ignore", "ignore"]
+        });
+      }
+    } catch {
+    }
+  }
+  generateInstanceId() {
+    return uuidv4().substring(0, 8);
+  }
+  findStackMemory() {
+    const possiblePaths = [
+      path.join(os.homedir(), ".stackmemory", "bin", "stackmemory"),
+      "/usr/local/bin/stackmemory",
+      "/opt/homebrew/bin/stackmemory",
+      "stackmemory"
+    ];
+    for (const smPath of possiblePaths) {
+      try {
+        execFileSync("which", [smPath], { stdio: "ignore" });
+        return smPath;
+      } catch {
+      }
+    }
+    return "stackmemory";
+  }
+  isGitRepo() {
+    try {
+      execSync("git rev-parse --git-dir", { stdio: "ignore" });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  getCurrentBranch() {
+    try {
+      return execSync("git rev-parse --abbrev-ref HEAD", {
+        encoding: "utf8"
+      }).trim();
+    } catch {
+      return "main";
+    }
+  }
+  hasUncommittedChanges() {
+    try {
+      const status = execSync("git status --porcelain", { encoding: "utf8" });
+      return status.length > 0;
+    } catch {
+      return false;
+    }
+  }
+  resolveGeminiBin() {
+    if (this.config.geminiBin && this.config.geminiBin.trim()) {
+      return this.config.geminiBin.trim();
+    }
+    const envBin = process.env["GEMINI_BIN"];
+    if (envBin && envBin.trim()) return envBin.trim();
+    const possiblePaths = [
+      path.join(
+        os.homedir(),
+        ".nvm",
+        "versions",
+        "node",
+        "v22.22.0",
+        "bin",
+        "gemini"
+      ),
+      "/usr/local/bin/gemini",
+      "/opt/homebrew/bin/gemini"
+    ];
+    for (const binPath of possiblePaths) {
+      if (fs.existsSync(binPath)) {
+        return binPath;
+      }
+    }
+    try {
+      execSync("which gemini", { stdio: "ignore" });
+      return "gemini";
+    } catch {
+    }
+    return null;
+  }
+  setupWorktree() {
+    if (!this.config.useWorktree || !this.isGitRepo()) {
+      return null;
+    }
+    console.log(chalk.blue("Setting up isolated worktree..."));
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").substring(0, 19);
+    const branch = this.config.branch || `gemini-${this.config.task || "work"}-${timestamp}-${this.config.instanceId}`;
+    const repoName = path.basename(process.cwd());
+    const worktreePath = path.join(
+      path.dirname(process.cwd()),
+      `${repoName}--${branch}`
+    );
+    try {
+      const cmd = `git worktree add -b "${branch}" "${worktreePath}"`;
+      execSync(cmd, { stdio: "inherit" });
+      console.log(chalk.green(`Worktree created: ${worktreePath}`));
+      console.log(chalk.gray(`Branch: ${branch}`));
+      const configPath = path.join(worktreePath, ".gemini-instance.json");
+      const configData = {
+        instanceId: this.config.instanceId,
+        worktreePath,
+        branch,
+        task: this.config.task,
+        created: (/* @__PURE__ */ new Date()).toISOString(),
+        parentRepo: process.cwd()
+      };
+      fs.writeFileSync(configPath, JSON.stringify(configData, null, 2));
+      const envFiles = [".env", ".env.local", ".mise.toml", ".tool-versions"];
+      for (const file of envFiles) {
+        const srcPath = path.join(process.cwd(), file);
+        if (fs.existsSync(srcPath)) {
+          fs.copyFileSync(srcPath, path.join(worktreePath, file));
+        }
+      }
+      return worktreePath;
+    } catch (err) {
+      console.error(chalk.red("Failed to create worktree:"), err);
+      return null;
+    }
+  }
+  saveContext(message, metadata = {}) {
+    if (!this.config.contextEnabled) return;
+    try {
+      const contextData = {
+        message,
+        metadata: {
+          ...metadata,
+          instanceId: this.config.instanceId,
+          worktree: this.config.worktreePath,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          tool: "gemini"
+        }
+      };
+      const cmd = `${this.stackmemoryPath} context save --json '${JSON.stringify(contextData)}'`;
+      execSync(cmd, { stdio: "ignore" });
+    } catch {
+    }
+  }
+  loadContext() {
+    if (!this.config.contextEnabled) return;
+    try {
+      console.log(chalk.blue("Loading previous context..."));
+      const cmd = `${this.stackmemoryPath} context show`;
+      const output = execSync(cmd, {
+        encoding: "utf8",
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      const lines = output.trim().split("\n").filter((l) => l.trim());
+      if (lines.length > 3) {
+        console.log(chalk.gray("Context stack loaded"));
+      }
+    } catch {
+    }
+  }
+  detectMultipleInstances() {
+    try {
+      const lockDir = path.join(process.cwd(), ".gemini-worktree-locks");
+      if (!fs.existsSync(lockDir)) return false;
+      const locks = fs.readdirSync(lockDir).filter((f) => f.endsWith(".lock"));
+      const activeLocks = locks.filter((lockFile) => {
+        const lockPath = path.join(lockDir, lockFile);
+        const lockData = JSON.parse(fs.readFileSync(lockPath, "utf8"));
+        const lockAge = Date.now() - new Date(lockData.created).getTime();
+        return lockAge < 24 * 60 * 60 * 1e3;
+      });
+      return activeLocks.length > 0;
+    } catch {
+      return false;
+    }
+  }
+  suggestWorktreeMode() {
+    if (this.hasUncommittedChanges()) {
+      console.log(chalk.yellow("Uncommitted changes detected"));
+      console.log(chalk.gray("Consider using --worktree to work in isolation"));
+    }
+    if (this.detectMultipleInstances()) {
+      console.log(chalk.yellow("Other Gemini instances detected"));
+      console.log(
+        chalk.gray("Using --worktree is recommended to avoid conflicts")
+      );
+    }
+  }
+  async run(args) {
+    const geminiArgs = [];
+    let i = 0;
+    while (i < args.length) {
+      const arg = args[i];
+      switch (arg) {
+        case "--worktree":
+        case "-w":
+          this.config.useWorktree = true;
+          break;
+        case "--no-worktree":
+        case "-W":
+          this.config.useWorktree = false;
+          break;
+        case "--no-context":
+          this.config.contextEnabled = false;
+          break;
+        case "--no-trace":
+          this.config.tracingEnabled = false;
+          break;
+        case "--verbose-trace":
+          this.config.verboseTracing = true;
+          break;
+        case "--branch":
+        case "-b":
+          i++;
+          this.config.branch = args[i];
+          break;
+        case "--task":
+        case "-t":
+          i++;
+          this.config.task = args[i];
+          break;
+        case "--gemini-bin":
+          i++;
+          this.config.geminiBin = args[i];
+          process.env["GEMINI_BIN"] = this.config.geminiBin;
+          break;
+        case "--auto":
+        case "-a":
+          if (this.isGitRepo()) {
+            this.config.useWorktree = this.hasUncommittedChanges() || this.detectMultipleInstances();
+          }
+          break;
+        default:
+          geminiArgs.push(arg);
+      }
+      i++;
+    }
+    if (this.config.tracingEnabled) {
+      process.env["DEBUG_TRACE"] = "true";
+      process.env["STACKMEMORY_DEBUG"] = "true";
+      process.env["TRACE_OUTPUT"] = "file";
+      process.env["TRACE_MASK_SENSITIVE"] = "true";
+      if (this.config.verboseTracing) {
+        process.env["TRACE_VERBOSITY"] = "full";
+        process.env["TRACE_PARAMS"] = "true";
+        process.env["TRACE_RESULTS"] = "true";
+        process.env["TRACE_MEMORY"] = "true";
+      } else {
+        process.env["TRACE_VERBOSITY"] = "summary";
+        process.env["TRACE_PARAMS"] = "true";
+        process.env["TRACE_RESULTS"] = "false";
+      }
+      initializeTracing();
+      trace.command(
+        "gemini-sm",
+        {
+          instanceId: this.config.instanceId,
+          worktree: this.config.useWorktree,
+          task: this.config.task
+        },
+        async () => {
+        }
+      );
+    }
+    console.log(chalk.cyan("Gemini + StackMemory"));
+    console.log();
+    this.ensureInitialized();
+    if (this.isGitRepo()) {
+      const branch = this.getCurrentBranch();
+      console.log(chalk.gray(`Branch: ${branch}`));
+      if (!this.config.useWorktree) {
+        this.suggestWorktreeMode();
+      }
+    }
+    if (this.config.useWorktree) {
+      const worktreePath = this.setupWorktree();
+      if (worktreePath) {
+        this.config.worktreePath = worktreePath;
+        process.chdir(worktreePath);
+        this.saveContext("Created worktree for Gemini instance", {
+          action: "worktree_created",
+          path: worktreePath,
+          branch: this.config.branch
+        });
+      }
+    }
+    this.loadContext();
+    process.env["GEMINI_INSTANCE_ID"] = this.config.instanceId;
+    if (this.config.worktreePath) {
+      process.env["GEMINI_WORKTREE_PATH"] = this.config.worktreePath;
+    }
+    console.log(chalk.gray(`Instance: ${this.config.instanceId}`));
+    console.log(chalk.gray(`Working in: ${process.cwd()}`));
+    if (this.config.tracingEnabled) {
+      console.log(
+        chalk.gray(`Tracing enabled (logs to ~/.stackmemory/traces/)`)
+      );
+    }
+    console.log();
+    console.log(chalk.gray("Starting Gemini CLI..."));
+    console.log(chalk.gray("-".repeat(40)));
+    const geminiBin = this.resolveGeminiBin();
+    if (!geminiBin) {
+      console.error(chalk.red("Gemini CLI not found."));
+      console.log(
+        chalk.gray(
+          "Install Gemini CLI or set an override:\n  npm install -g @anthropic-ai/gemini-cli\n  export GEMINI_BIN=/path/to/gemini\n  gemini-sm --help"
+        )
+      );
+      process.exit(1);
+      return;
+    }
+    const gemini = spawn(geminiBin, geminiArgs, {
+      stdio: "inherit",
+      env: process.env
+    });
+    gemini.on("error", (err) => {
+      console.error(chalk.red("Failed to launch Gemini CLI."));
+      if (err.code === "ENOENT") {
+        console.error(
+          chalk.gray("Not found. Set GEMINI_BIN or install gemini.")
+        );
+      } else {
+        console.error(chalk.gray(`${err.message}`));
+      }
+      process.exit(1);
+    });
+    gemini.on("exit", async (code) => {
+      this.saveContext("Gemini session ended", {
+        action: "session_end",
+        exitCode: code
+      });
+      if (this.config.tracingEnabled) {
+        const summary = trace.getExecutionSummary();
+        console.log();
+        console.log(chalk.gray("-".repeat(40)));
+        console.log(chalk.cyan("Trace Summary:"));
+        console.log(chalk.gray(summary));
+      }
+      if (this.config.worktreePath) {
+        console.log();
+        console.log(chalk.gray("-".repeat(40)));
+        console.log(chalk.cyan("Session ended in worktree:"));
+        console.log(chalk.gray(`  ${this.config.worktreePath}`));
+      }
+      process.exit(code || 0);
+    });
+    process.on("SIGINT", () => {
+      this.saveContext("Gemini session interrupted", {
+        action: "session_interrupt"
+      });
+      gemini.kill("SIGINT");
+    });
+    process.on("SIGTERM", () => {
+      this.saveContext("Gemini session terminated", {
+        action: "session_terminate"
+      });
+      gemini.kill("SIGTERM");
+    });
+  }
+}
+program.name("gemini-sm").description("Gemini CLI with StackMemory context and worktree isolation").version("1.0.0");
+const configCmd = program.command("config").description("Manage gemini-sm defaults");
+configCmd.command("show").description("Show current default settings").action(() => {
+  const config = loadSMConfig();
+  console.log(chalk.cyan("gemini-sm defaults:"));
+  console.log(
+    `  defaultWorktree: ${config.defaultWorktree ? chalk.green("true") : chalk.gray("false")}`
+  );
+  console.log(
+    `  defaultTracing:  ${config.defaultTracing ? chalk.green("true") : chalk.gray("false")}`
+  );
+  console.log(chalk.gray(`
+Config: ${getConfigPath()}`));
+});
+configCmd.command("set <key> <value>").description("Set a default (e.g., set worktree true)").action((key, value) => {
+  const config = loadSMConfig();
+  const boolValue = value === "true" || value === "1" || value === "on";
+  const keyMap = {
+    worktree: "defaultWorktree",
+    tracing: "defaultTracing"
+  };
+  const configKey = keyMap[key];
+  if (!configKey) {
+    console.log(chalk.red(`Unknown key: ${key}`));
+    console.log(chalk.gray("Valid keys: worktree, tracing"));
+    process.exit(1);
+  }
+  config[configKey] = boolValue;
+  saveSMConfig(config);
+  console.log(chalk.green(`Set ${key} = ${boolValue}`));
+});
+configCmd.command("worktree-on").description("Enable worktree mode by default").action(() => {
+  const config = loadSMConfig();
+  config.defaultWorktree = true;
+  saveSMConfig(config);
+  console.log(chalk.green("Worktree mode enabled by default"));
+});
+configCmd.command("worktree-off").description("Disable worktree mode by default").action(() => {
+  const config = loadSMConfig();
+  config.defaultWorktree = false;
+  saveSMConfig(config);
+  console.log(chalk.green("Worktree mode disabled by default"));
+});
+program.option("-w, --worktree", "Create isolated worktree for this instance").option("-W, --no-worktree", "Disable worktree (override default)").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("--gemini-bin <path>", "Path to gemini CLI (or use GEMINI_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").helpOption("-h, --help", "Display help").allowUnknownOption(true).action(async (_options) => {
+  const geminiSM = new GeminiSM();
+  const args = process.argv.slice(2);
+  await geminiSM.run(args);
+});
+program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackmemoryai/stackmemory",
-  "version": "1.5.5",
+  "version": "1.5.7",
   "description": "Lossless, project-scoped memory for AI coding tools. Durable context across sessions with 56 MCP tools, FTS5 search, conductor orchestrator, loop/watch monitoring, snapshot capture, pre-flight overlap checks, Claude/Codex/OpenCode wrappers, Linear sync, and automatic hooks.",
   "engines": {
     "node": ">=20.0.0",
@@ -14,7 +14,8 @@
     "codex-smd": "bin/codex-smd",
     "claude-sm": "bin/claude-sm",
     "claude-smd": "bin/claude-smd",
-    "opencode-sm": "bin/opencode-sm"
+    "opencode-sm": "bin/opencode-sm",
+    "gemini-sm": "bin/gemini-sm"
   },
   "files": [
     "bin",