@keepgoingdev/cli 1.4.0 → 1.6.0

package/README.md

@@ -38,14 +38,27 @@ Flags:
 
 ### `keepgoing save`
 
-Save a new checkpoint interactively. Prompts for:
-
-1. What did you work on? (required)
-2. What's your next step? (required)
-3. Any blockers? (optional)
+Save a new checkpoint. By default, auto-generates the summary and next step from recent git activity (commits and touched files). No interactive prompts.
 
 Git branch and touched files are auto-detected from the workspace.
 
+Flags:
+
+- `-m, --message <text>` — use a custom summary instead of auto-generating
+- `-n, --next <text>` — use a custom next step instead of auto-generating
+- `--force` — save even if a recent checkpoint exists or there are no detected changes
+- `--json` — output raw JSON
+- `--quiet` — suppress output
+- `--cwd <path>` — override the working directory
+
+Examples:
+
+```bash
+keepgoing save                         # auto-generate from git
+keepgoing save -m "Finished auth flow" # custom summary
+keepgoing save --force                 # save even if no changes
+```
+
 ### `keepgoing hook install`
 
 Install a shell hook that runs `keepgoing status --quiet` automatically whenever you `cd` into a directory that contains `.keepgoing/`.

package/dist/index.js

@@ -2801,96 +2801,7 @@ function renderEnrichedBriefingQuiet(briefing) {
   console.log(`KeepGoing \xB7 ${core.lastWorked} \xB7 Focus: ${core.currentFocus} \xB7 Next: ${core.smallNextStep}`);
 }
 
-// src/updateCheck.ts
-import { spawn } from "child_process";
-import { readFileSync, existsSync } from "fs";
-import path11 from "path";
-import os5 from "os";
-var CLI_VERSION = "1.4.0";
-var NPM_REGISTRY_URL = "https://registry.npmjs.org/@keepgoingdev/cli/latest";
-var FETCH_TIMEOUT_MS = 5e3;
-var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
-var CACHE_DIR = path11.join(os5.homedir(), ".keepgoing");
-var CACHE_PATH = path11.join(CACHE_DIR, "update-check.json");
-function isNewerVersion(current, latest) {
-  const cur = current.split(".").map(Number);
-  const lat = latest.split(".").map(Number);
-  for (let i = 0; i < 3; i++) {
-    if ((lat[i] ?? 0) > (cur[i] ?? 0)) return true;
-    if ((lat[i] ?? 0) < (cur[i] ?? 0)) return false;
-  }
-  return false;
-}
-function getCachedUpdateInfo() {
-  try {
-    if (!existsSync(CACHE_PATH)) return null;
-    const raw = readFileSync(CACHE_PATH, "utf-8");
-    const cache = JSON.parse(raw);
-    if (!cache.latest || !cache.checkedAt) return null;
-    const age = Date.now() - new Date(cache.checkedAt).getTime();
-    if (age > CHECK_INTERVAL_MS || cache.current !== CLI_VERSION) return null;
-    return {
-      current: CLI_VERSION,
-      latest: cache.latest,
-      updateAvailable: isNewerVersion(CLI_VERSION, cache.latest)
-    };
-  } catch {
-    return null;
-  }
-}
-function spawnBackgroundCheck() {
-  try {
-    if (existsSync(CACHE_PATH)) {
-      const raw = readFileSync(CACHE_PATH, "utf-8");
-      const cache = JSON.parse(raw);
-      const age = Date.now() - new Date(cache.checkedAt).getTime();
-      if (age < CHECK_INTERVAL_MS && cache.current === CLI_VERSION) return;
-    }
-  } catch {
-  }
-  const script = `
-    const https = require('https');
-    const fs = require('fs');
-    const path = require('path');
-    const os = require('os');
-
-    const url = ${JSON.stringify(NPM_REGISTRY_URL)};
-    const cacheDir = path.join(os.homedir(), '.keepgoing');
-    const cachePath = path.join(cacheDir, 'update-check.json');
-    const currentVersion = ${JSON.stringify(CLI_VERSION)};
-
-    const req = https.get(url, { timeout: ${FETCH_TIMEOUT_MS} }, (res) => {
-      let data = '';
-      res.on('data', (chunk) => { data += chunk; });
-      res.on('end', () => {
-        try {
-          const latest = JSON.parse(data).version;
-          if (!latest) process.exit(0);
-          if (!fs.existsSync(cacheDir)) fs.mkdirSync(cacheDir, { recursive: true });
-          fs.writeFileSync(cachePath, JSON.stringify({
-            latest,
-            current: currentVersion,
-            checkedAt: new Date().toISOString(),
-          }));
-        } catch {}
-        process.exit(0);
-      });
-    });
-    req.on('error', () => process.exit(0));
-    req.on('timeout', () => { req.destroy(); process.exit(0); });
-  `;
-  const child = spawn(process.execPath, ["-e", script], {
-    detached: true,
-    stdio: "ignore",
-    env: { ...process.env }
-  });
-  child.unref();
-}
-
 // src/commands/status.ts
-var RESET2 = "\x1B[0m";
-var BOLD2 = "\x1B[1m";
-var DIM2 = "\x1B[2m";
 async function statusCommand(opts) {
   const reader = new KeepGoingReader(opts.cwd);
   if (!reader.exists()) {
@@ -2918,15 +2829,10 @@ async function statusCommand(opts) {
     (Date.now() - new Date(lastSession.timestamp).getTime()) / (1e3 * 60 * 60 * 24)
   );
   renderCheckpoint(lastSession, daysSince);
-  const cached = getCachedUpdateInfo();
-  if (cached?.updateAvailable) {
-    console.log(`${DIM2}Update available: ${cached.current} \u2192 ${cached.latest}. Run: ${RESET2}${BOLD2}npm install -g @keepgoingdev/cli@latest${RESET2}`);
-  }
-  spawnBackgroundCheck();
 }
 
 // src/commands/save.ts
-import path12 from "path";
+import path11 from "path";
 async function saveCommand(opts) {
   const { cwd, message, nextStepOverride, json, quiet, force } = opts;
   const isManual = !!message;
@@ -2955,9 +2861,9 @@ async function saveCommand(opts) {
     sessionStartTime: lastSession?.timestamp ?? now,
     lastActivityTime: now
   });
-  const summary = message ?? buildSmartSummary(events) ?? `Worked on ${touchedFiles.slice(0, 5).map((f) => path12.basename(f)).join(", ")}`;
+  const summary = message ?? buildSmartSummary(events) ?? `Worked on ${touchedFiles.slice(0, 5).map((f) => path11.basename(f)).join(", ")}`;
   const nextStep = nextStepOverride ?? buildSmartNextStep(events);
-  const projectName = path12.basename(resolveStorageRoot(cwd));
+  const projectName = path11.basename(resolveStorageRoot(cwd));
   const sessionId = generateSessionId({
     workspaceRoot: cwd,
     branch: gitBranch ?? void 0,
@@ -2991,16 +2897,16 @@ async function saveCommand(opts) {
 
 // src/commands/hook.ts
 import fs9 from "fs";
-import path13 from "path";
-import os6 from "os";
+import path12 from "path";
+import os5 from "os";
 import { execSync as execSync2 } from "child_process";
 var HOOK_MARKER_START = "# keepgoing-hook-start";
 var HOOK_MARKER_END = "# keepgoing-hook-end";
 var POST_COMMIT_MARKER_START = "# keepgoing-post-commit-start";
 var POST_COMMIT_MARKER_END = "# keepgoing-post-commit-end";
-var KEEPGOING_HOOKS_DIR = path13.join(os6.homedir(), ".keepgoing", "hooks");
-var POST_COMMIT_HOOK_PATH = path13.join(KEEPGOING_HOOKS_DIR, "post-commit");
-var KEEPGOING_MANAGED_MARKER = path13.join(KEEPGOING_HOOKS_DIR, ".keepgoing-managed");
+var KEEPGOING_HOOKS_DIR = path12.join(os5.homedir(), ".keepgoing", "hooks");
+var POST_COMMIT_HOOK_PATH = path12.join(KEEPGOING_HOOKS_DIR, "post-commit");
+var KEEPGOING_MANAGED_MARKER = path12.join(KEEPGOING_HOOKS_DIR, ".keepgoing-managed");
 var POST_COMMIT_HOOK = `#!/bin/sh
 ${POST_COMMIT_MARKER_START}
 # Runs after every git commit. Detects high-signal decisions.
@@ -3041,7 +2947,7 @@ if command -v keepgoing >/dev/null 2>&1
 end
 ${HOOK_MARKER_END}`;
 function detectShellInfo(shellOverride) {
-  const home = os6.homedir();
+  const home = os5.homedir();
   let shell;
   if (shellOverride) {
     shell = shellOverride.toLowerCase();
@@ -3064,14 +2970,14 @@ function detectShellInfo(shellOverride) {
     }
   }
   if (shell === "zsh") {
-    return { shell: "zsh", rcFile: path13.join(home, ".zshrc") };
+    return { shell: "zsh", rcFile: path12.join(home, ".zshrc") };
   }
   if (shell === "bash") {
-    return { shell: "bash", rcFile: path13.join(home, ".bashrc") };
+    return { shell: "bash", rcFile: path12.join(home, ".bashrc") };
   }
   if (shell === "fish") {
-    const xdgConfig = process.env["XDG_CONFIG_HOME"] || path13.join(home, ".config");
-    return { shell: "fish", rcFile: path13.join(xdgConfig, "fish", "config.fish") };
+    const xdgConfig = process.env["XDG_CONFIG_HOME"] || path12.join(home, ".config");
+    return { shell: "fish", rcFile: path12.join(xdgConfig, "fish", "config.fish") };
   }
   return void 0;
 }
@@ -3102,11 +3008,11 @@ function resolveGlobalGitignorePath() {
       stdio: ["pipe", "pipe", "pipe"]
     }).trim();
     if (configured) {
-      return configured.startsWith("~") ? path13.join(os6.homedir(), configured.slice(1)) : configured;
+      return configured.startsWith("~") ? path12.join(os5.homedir(), configured.slice(1)) : configured;
     }
   } catch {
   }
-  return path13.join(os6.homedir(), ".gitignore_global");
+  return path12.join(os5.homedir(), ".gitignore_global");
 }
 function performGlobalGitignore() {
   const ignorePath = resolveGlobalGitignorePath();
@@ -3426,12 +3332,12 @@ async function briefingCommand(opts) {
 }
 
 // src/commands/init.ts
-var RESET3 = "\x1B[0m";
-var BOLD3 = "\x1B[1m";
+var RESET2 = "\x1B[0m";
+var BOLD2 = "\x1B[1m";
 var GREEN2 = "\x1B[32m";
 var YELLOW2 = "\x1B[33m";
 var CYAN2 = "\x1B[36m";
-var DIM3 = "\x1B[2m";
+var DIM2 = "\x1B[2m";
 function initCommand(options) {
   const scope = options.scope === "user" ? "user" : "project";
   const result = setupProject({
@@ -3439,7 +3345,7 @@ function initCommand(options) {
     scope
   });
   console.log(`
-${BOLD3}KeepGoing Init${RESET3} ${DIM3}(${scope} scope)${RESET3}
+${BOLD2}KeepGoing Init${RESET2} ${DIM2}(${scope} scope)${RESET2}
 `);
   for (const msg of result.messages) {
     const colonIdx = msg.indexOf(":");
@@ -3450,16 +3356,16 @@ ${BOLD3}KeepGoing Init${RESET3} ${DIM3}(${scope} scope)${RESET3}
     const label = msg.slice(0, colonIdx + 1);
     const body = msg.slice(colonIdx + 1);
     if (label.startsWith("Warning")) {
-      console.log(`  ${YELLOW2}${label}${RESET3}${body}`);
+      console.log(`  ${YELLOW2}${label}${RESET2}${body}`);
     } else if (body.includes("Added")) {
-      console.log(`  ${GREEN2}${label}${RESET3}${body}`);
+      console.log(`  ${GREEN2}${label}${RESET2}${body}`);
     } else {
-      console.log(`  ${CYAN2}${label}${RESET3}${body}`);
+      console.log(`  ${CYAN2}${label}${RESET2}${body}`);
     }
   }
   if (result.changed) {
     console.log(`
-${GREEN2}Done!${RESET3} KeepGoing is set up for this project.
+${GREEN2}Done!${RESET2} KeepGoing is set up for this project.
 `);
   } else {
     console.log(`
@@ -3470,8 +3376,8 @@ Everything was already configured. No changes made.
 
 // src/commands/setup.ts
 import fs10 from "fs";
-import path14 from "path";
-import os7 from "os";
+import path13 from "path";
+import os6 from "os";
 import { execSync as execSync3, exec as exec2 } from "child_process";
 import { promisify as promisify2 } from "util";
 
@@ -5396,14 +5302,15 @@ function cancelAndExit() {
 
 // src/commands/setup.ts
 var execAsync = promisify2(exec2);
-var VALID_PRESETS = ["vscode", "claude", "copilot", "cursor", "windsurf", "jetbrains"];
+var VALID_PRESETS = ["vscode", "claude", "copilot", "cursor", "windsurf", "jetbrains", "desktop-tray"];
 var PRESET_DEFAULTS = {
   vscode: { ide: ["vscode"] },
   jetbrains: { ide: ["jetbrains"] },
   claude: { tools: ["claude-code"] },
   copilot: { tools: ["copilot"] },
   cursor: { tools: ["cursor"] },
-  windsurf: { tools: ["windsurf"] }
+  windsurf: { tools: ["windsurf"] },
+  "desktop-tray": { desktopTray: true }
 };
 var PRESET_LABELS = {
   vscode: "VS Code",
@@ -5411,7 +5318,8 @@ var PRESET_LABELS = {
   claude: "Claude Code",
   copilot: "GitHub Copilot",
   cursor: "Cursor",
-  windsurf: "Windsurf"
+  windsurf: "Windsurf",
+  "desktop-tray": "Desktop Tray"
 };
 var JETBRAINS_PLUGIN_URL = "https://plugins.jetbrains.com/plugin/30449-keepgoing";
 var JETBRAINS_PLUGIN_ID = "com.keepgoing.plugin";
@@ -5433,14 +5341,14 @@ function detectJetBrainsIdes() {
   if (process.platform !== "darwin") return [];
   return JETBRAINS_IDES.filter((ide) => {
     try {
-      return fs10.statSync(path14.join("/Applications", ide.app)).isDirectory();
+      return fs10.statSync(path13.join("/Applications", ide.app)).isDirectory();
     } catch {
       return false;
     }
   });
 }
 async function setupCommand(options) {
-  const displayPath = options.cwd.startsWith(os7.homedir()) ? "~" + options.cwd.slice(os7.homedir().length) : options.cwd;
+  const displayPath = options.cwd.startsWith(os6.homedir()) ? "~" + options.cwd.slice(os6.homedir().length) : options.cwd;
   const presetDefaults = options.preset ? PRESET_DEFAULTS[options.preset] : void 0;
   const presetLabel = options.preset ? PRESET_LABELS[options.preset] : void 0;
   dist_exports.intro(presetLabel ? `KeepGoing Setup - ${presetLabel}` : "KeepGoing Setup Wizard");
@@ -5461,7 +5369,7 @@ async function setupCommand(options) {
     tools = presetDefaults.tools;
     dist_exports.log.step(`AI tool: ${tools.map((t2) => t2 === "claude-code" ? "Claude Code" : t2.charAt(0).toUpperCase() + t2.slice(1)).join(", ")}`);
     const addMore = await dist_exports.multiselect({
-      message: "Also configure any of these?",
+      message: "Also configure any of these? (enter to skip)",
       options: [
         ...!tools.includes("claude-code") ? [{ label: "Claude Code", value: "claude-code" }] : [],
         ...!tools.includes("copilot") ? [{ label: "GitHub Copilot", value: "copilot" }] : [],
@@ -5500,12 +5408,14 @@ async function setupCommand(options) {
     if (isCancel(pluginAnswer)) cancelAndExit();
     claudePlugin = pluginAnswer === "plugin";
   }
+  const IDE_TOOLS = ["cursor", "windsurf"];
+  const hasIdeTool = tools.some((t2) => IDE_TOOLS.includes(t2));
   let ide;
   if (presetDefaults?.ide) {
     ide = presetDefaults.ide;
     dist_exports.log.step(`IDE: ${ide.map((i) => i === "vscode" ? "VS Code" : i === "jetbrains" ? "JetBrains" : "Terminal").join(", ")}`);
     const addMoreIde = await dist_exports.multiselect({
-      message: "Also configure any of these?",
+      message: "Also configure any of these? (enter to skip)",
       options: [
         ...!ide.includes("vscode") ? [{ label: "VS Code", value: "vscode" }] : [],
         ...!ide.includes("jetbrains") ? [{ label: "JetBrains", hint: "IntelliJ, WebStorm, PyCharm, etc.", value: "jetbrains" }] : [],
@@ -5516,6 +5426,19 @@ async function setupCommand(options) {
     if (!isCancel(addMoreIde) && addMoreIde.length > 0) {
       ide = [...ide, ...addMoreIde];
     }
+  } else if (hasIdeTool) {
+    ide = [];
+    const addIdeExtensions = await dist_exports.multiselect({
+      message: "Also configure IDE extensions? (enter to skip)",
+      options: [
+        { label: "VS Code", value: "vscode" },
+        { label: "JetBrains", hint: "IntelliJ, WebStorm, PyCharm, etc.", value: "jetbrains" }
+      ],
+      required: false
+    });
+    if (!isCancel(addIdeExtensions) && addIdeExtensions.length > 0) {
+      ide = addIdeExtensions;
+    }
   } else {
     const ideAnswer = await dist_exports.multiselect({
       message: "Which IDE(s) do you use?",
@@ -5735,6 +5658,83 @@ async function setupCommand(options) {
       }
     }
   }
+  let installDesktopTray = false;
+  const trayPreset = presetDefaults?.desktopTray === true;
+  if (process.platform === "darwin") {
+    const alreadyInstalled = fs10.existsSync("/Applications/KeepGoing.app");
+    if (alreadyInstalled) {
+      dist_exports.log.message(`${DIM5}Desktop tray: Already installed${RESET5}`);
+      installDesktopTray = true;
+    } else {
+      if (!trayPreset) {
+        dist_exports.note(
+          "A menubar app that shows re-entry briefings, active sessions,\nand momentum across all your projects. Editor-agnostic, free.",
+          "Desktop Tray"
+        );
+      }
+      const wantsTray = trayPreset || await (async () => {
+        const trayAnswer = await dist_exports.confirm({
+          message: "Install the desktop tray app?",
+          initialValue: trayPreset,
+          active: "Yes",
+          inactive: "No, skip"
+        });
+        return !isCancel(trayAnswer) && trayAnswer;
+      })();
+      if (wantsTray) {
+        installDesktopTray = true;
+        let installed = false;
+        let hasHomebrew = false;
+        try {
+          execSync3("brew --version", { stdio: "pipe" });
+          hasHomebrew = true;
+        } catch {
+        }
+        if (hasHomebrew) {
+          const ts = dist_exports.spinner();
+          ts.start("Installing desktop tray via Homebrew...");
+          try {
+            const { stderr } = await execAsync(
+              "brew tap keepgoing-dev/tap && brew install --cask keepgoing",
+              { timeout: 12e4 }
+            );
+            if (stderr?.includes("already installed")) {
+              ts.stop("Desktop tray: Already installed via Homebrew");
+            } else {
+              ts.stop("Desktop tray installed");
+            }
+            installed = true;
+            try {
+              execSync3("open -a KeepGoing", { stdio: "pipe" });
+            } catch {
+            }
+          } catch {
+            ts.stop("Homebrew install failed");
+          }
+        }
+        if (!installed) {
+          dist_exports.log.info(
+            "Install manually:\n    1. Download from https://github.com/keepgoing-dev/releases/releases/latest\n    2. Drag KeepGoing.app to /Applications\n    3. Run: xattr -cr /Applications/KeepGoing.app\n    4. Open KeepGoing from Applications"
+          );
+        }
+      } else {
+        dist_exports.log.info("Desktop tray: Install anytime with:\n    brew tap keepgoing-dev/tap && brew install --cask keepgoing");
+      }
+    }
+    if (installDesktopTray) {
+      try {
+        const existing = readTrayConfigProjects();
+        if (!existing.includes(options.cwd)) {
+          const trayConfigDir = path13.join(os6.homedir(), ".keepgoing");
+          fs10.mkdirSync(trayConfigDir, { recursive: true });
+          const trayConfigPath = path13.join(trayConfigDir, "tray-config.json");
+          const updated = { projects: [...existing, options.cwd] };
+          fs10.writeFileSync(trayConfigPath, JSON.stringify(updated, null, 2) + "\n", "utf-8");
+        }
+      } catch {
+      }
+    }
+  }
   if (hasLicense) {
     const key = await dist_exports.text({
       message: "Enter your license key",
@@ -5791,12 +5791,13 @@ async function setupCommand(options) {
     scope,
     shellHook: installShellHook,
     claudePlugin,
+    desktopTray: installDesktopTray,
     licensed
   };
-  const keepgoingDir = path14.join(os7.homedir(), ".keepgoing");
+  const keepgoingDir = path13.join(os6.homedir(), ".keepgoing");
   fs10.mkdirSync(keepgoingDir, { recursive: true });
   fs10.writeFileSync(
-    path14.join(keepgoingDir, "setup-profile.json"),
+    path13.join(keepgoingDir, "setup-profile.json"),
     JSON.stringify(profile, null, 2) + "\n",
     "utf-8"
   );
@@ -6007,8 +6008,8 @@ function filterDecisions(decisions, opts) {
 }
 
 // src/commands/log.ts
-var RESET4 = "\x1B[0m";
-var DIM4 = "\x1B[2m";
+var RESET3 = "\x1B[0m";
+var DIM3 = "\x1B[2m";
 function logSessions(reader, opts) {
   const { effectiveBranch } = reader.resolveBranchScope(opts.branch || void 0);
   let sessions = reader.getSessions();
@@ -6019,7 +6020,7 @@ function logSessions(reader, opts) {
   sessions = filterSessions(sessions, opts);
   const totalFiltered = sessions.length;
   if (totalFiltered === 0) {
-    console.log(`${DIM4}No checkpoints match the given filters.${RESET4}`);
+    console.log(`${DIM3}No checkpoints match the given filters.${RESET3}`);
     return;
   }
   const displayed = sessions.slice(0, opts.count);
@@ -6043,7 +6044,7 @@ function logSessions(reader, opts) {
     }
   }
   if (totalFiltered > opts.count) {
-    console.log(`${DIM4}(showing ${displayed.length} of ${totalFiltered} checkpoints)${RESET4}`);
+    console.log(`${DIM3}(showing ${displayed.length} of ${totalFiltered} checkpoints)${RESET3}`);
   }
 }
 function renderGrouped(sessions, showStat) {
@@ -6082,7 +6083,7 @@ async function logDecisions(reader, opts) {
   decisions = filterDecisions(decisions, opts);
   const totalFiltered = decisions.length;
   if (totalFiltered === 0) {
-    console.log(`${DIM4}No decisions match the given filters.${RESET4}`);
+    console.log(`${DIM3}No decisions match the given filters.${RESET3}`);
     return;
   }
   const displayed = decisions.slice(0, opts.count);
@@ -6104,7 +6105,7 @@ async function logDecisions(reader, opts) {
     }
   }
   if (totalFiltered > opts.count) {
-    console.log(`${DIM4}(showing ${displayed.length} of ${totalFiltered} decisions)${RESET4}`);
+    console.log(`${DIM3}(showing ${displayed.length} of ${totalFiltered} decisions)${RESET3}`);
   }
 }
 async function logCommand(opts) {
@@ -6245,6 +6246,154 @@ function hotCommand(opts) {
   }
 }
 
+// src/commands/update.ts
+import { execSync as execSync5 } from "child_process";
+
+// src/updateCheck.ts
+import { spawn } from "child_process";
+import { readFileSync, existsSync } from "fs";
+import path14 from "path";
+import os7 from "os";
+var CLI_VERSION = "1.6.0";
+var NPM_REGISTRY_URL = "https://registry.npmjs.org/@keepgoingdev/cli/latest";
+var FETCH_TIMEOUT_MS = 5e3;
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var CACHE_DIR = path14.join(os7.homedir(), ".keepgoing");
+var CACHE_PATH = path14.join(CACHE_DIR, "update-check.json");
+function isNewerVersion(current, latest) {
+  const cur = current.split(".").map(Number);
+  const lat = latest.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((lat[i] ?? 0) > (cur[i] ?? 0)) return true;
+    if ((lat[i] ?? 0) < (cur[i] ?? 0)) return false;
+  }
+  return false;
+}
+function getCachedUpdateInfo() {
+  try {
+    if (!existsSync(CACHE_PATH)) return null;
+    const raw = readFileSync(CACHE_PATH, "utf-8");
+    const cache = JSON.parse(raw);
+    if (!cache.latest || !cache.checkedAt) return null;
+    const age = Date.now() - new Date(cache.checkedAt).getTime();
+    if (age > CHECK_INTERVAL_MS || cache.current !== CLI_VERSION) return null;
+    return {
+      current: CLI_VERSION,
+      latest: cache.latest,
+      updateAvailable: isNewerVersion(CLI_VERSION, cache.latest)
+    };
+  } catch {
+    return null;
+  }
+}
+function spawnBackgroundCheck() {
+  try {
+    if (existsSync(CACHE_PATH)) {
+      const raw = readFileSync(CACHE_PATH, "utf-8");
+      const cache = JSON.parse(raw);
+      const age = Date.now() - new Date(cache.checkedAt).getTime();
+      if (age < CHECK_INTERVAL_MS && cache.current === CLI_VERSION) return;
+    }
+  } catch {
+  }
+  const script = `
+    const https = require('https');
+    const fs = require('fs');
+    const path = require('path');
+    const os = require('os');
+
+    const url = ${JSON.stringify(NPM_REGISTRY_URL)};
+    const cacheDir = path.join(os.homedir(), '.keepgoing');
+    const cachePath = path.join(cacheDir, 'update-check.json');
+    const currentVersion = ${JSON.stringify(CLI_VERSION)};
+
+    const req = https.get(url, { timeout: ${FETCH_TIMEOUT_MS} }, (res) => {
+      let data = '';
+      res.on('data', (chunk) => { data += chunk; });
+      res.on('end', () => {
+        try {
+          const latest = JSON.parse(data).version;
+          if (!latest) process.exit(0);
+          if (!fs.existsSync(cacheDir)) fs.mkdirSync(cacheDir, { recursive: true });
+          fs.writeFileSync(cachePath, JSON.stringify({
+            latest,
+            current: currentVersion,
+            checkedAt: new Date().toISOString(),
+          }));
+        } catch {}
+        process.exit(0);
+      });
+    });
+    req.on('error', () => process.exit(0));
+    req.on('timeout', () => { req.destroy(); process.exit(0); });
+  `;
+  const child = spawn(process.execPath, ["-e", script], {
+    detached: true,
+    stdio: "ignore",
+    env: { ...process.env }
+  });
+  child.unref();
+}
+
+// src/commands/update.ts
+var RESET4 = "\x1B[0m";
+var BOLD3 = "\x1B[1m";
+var DIM4 = "\x1B[2m";
+var GREEN3 = "\x1B[32m";
+var YELLOW3 = "\x1B[33m";
+var CLI_VERSION2 = "1.6.0";
+async function updateCommand() {
+  console.log(`
+${BOLD3}KeepGoing CLI${RESET4} ${DIM4}v${CLI_VERSION2}${RESET4}
+`);
+  console.log(`${DIM4}Checking for updates...${RESET4}`);
+  let latest;
+  try {
+    latest = execSync5("npm view @keepgoingdev/cli version", {
+      encoding: "utf-8",
+      timeout: 1e4,
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+  } catch {
+    console.error(`${YELLOW3}Could not reach the npm registry. Check your network connection.${RESET4}
+`);
+    process.exit(1);
+  }
+  if (!latest) {
+    console.error(`${YELLOW3}Could not determine the latest version.${RESET4}
+`);
+    process.exit(1);
+  }
+  const current = CLI_VERSION2;
+  const updateAvailable = isNewerVersion(current, latest);
+  if (!updateAvailable) {
+    console.log(`${GREEN3}Already up to date.${RESET4}
+`);
+    return;
+  }
+  console.log(`${YELLOW3}Update available:${RESET4} ${DIM4}${current}${RESET4} -> ${BOLD3}${latest}${RESET4}
+`);
+  console.log(`${DIM4}Installing @keepgoingdev/cli@${latest}...${RESET4}
+`);
+  try {
+    execSync5(`npm install -g @keepgoingdev/cli@${latest}`, {
+      encoding: "utf-8",
+      timeout: 6e4,
+      stdio: "inherit"
+    });
+    console.log(`
+${GREEN3}Updated to v${latest}${RESET4}
+`);
+  } catch {
+    console.error(`
+${YELLOW3}Update failed.${RESET4} Try manually:
+`);
+    console.error(`  ${BOLD3}npm install -g @keepgoingdev/cli@latest${RESET4}
+`);
+    process.exit(1);
+  }
+}
+
 // src/index.ts
 var HELP_TEXT = `
 keepgoing: resume side projects without the mental friction
@@ -6264,6 +6413,7 @@ Commands:
   continue            Export context for use in another AI tool
   save                Save a checkpoint (auto-generates from git)
   hook                Manage the shell hook (zsh, bash, fish)
+  update              Update the CLI to the latest version
   activate <key>      Activate a Pro license on this device
   deactivate          Deactivate the Pro license from this device
 
@@ -6301,6 +6451,7 @@ Presets:
   windsurf        Pre-select Windsurf
   vscode          Pre-select VS Code IDE
   jetbrains       Pre-select JetBrains IDE
+  desktop-tray    Install the desktop tray app
 
 Options:
   --cwd <path>    Override the working directory
@@ -6428,6 +6579,13 @@ Usage: keepgoing activate <key>
 
 Example:
   keepgoing activate XXXX-XXXX-XXXX-XXXX
+`,
+  update: `
+keepgoing update: Update the CLI to the latest version
+
+Usage: keepgoing update
+
+Checks the npm registry for a newer version and installs it globally.
 `,
   deactivate: `
 keepgoing deactivate: Deactivate the Pro license from this device
@@ -6709,8 +6867,11 @@ async function main() {
         console.log(COMMAND_HELP.hook);
       }
       break;
+    case "update":
+      await updateCommand();
+      break;
     case "version":
-      console.log(`keepgoing v${"1.4.0"}`);
+      console.log(`keepgoing v${"1.6.0"}`);
       break;
     case "activate":
       await activateCommand({ licenseKey: subcommand });
@@ -6725,6 +6886,20 @@ async function main() {
       console.error(`Unknown command: "${command}". Run "keepgoing --help" for usage.`);
       process.exit(1);
   }
+  if (command && command !== "update" && command !== "version" && command !== "help" && !json && !quiet && !parsed.help) {
+    showUpdateHint();
+  }
+}
+function showUpdateHint() {
+  const cached = getCachedUpdateInfo();
+  if (cached?.updateAvailable) {
+    const DIM5 = "\x1B[2m";
+    const BOLD4 = "\x1B[1m";
+    const RESET5 = "\x1B[0m";
+    console.log(`
+${DIM5}Update available: ${cached.current} -> ${cached.latest}. Run:${RESET5} ${BOLD4}keepgoing update${RESET5}`);
+  }
+  spawnBackgroundCheck();
 }
 main().catch((err) => {
   console.error(err instanceof Error ? err.message : String(err));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keepgoingdev/cli",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Terminal CLI for KeepGoing. Resume side projects without the mental friction.",
   "type": "module",
   "main": "./dist/index.js",