claude-resume-hub 1.2.0 → 1.4.0

package/README.md

@@ -52,14 +52,17 @@ That's it. No install, no config. It works on **Windows, macOS and Linux**.
 ```bash
 npx claude-resume-hub              # no dashboard, just auto-resume
 npx claude-resume-hub --web        # with dashboard + alerts
-npx claude-resume-hub -t "run all tests and fix failures"   # start a task
+npx claude-resume-hub --tray       # background system-tray icon (Windows)
+npx claude-resume-hub -t "run all tests and fix failures"   # start a NEW session (not resume)
 npx claude-resume-hub --list       # list this project's sessions (+ their ids)
+npx claude-resume-hub --web --smart # context-aware resume (picks up your last step)
 npx claude-resume-hub -s <id>      # resume a specific session
 npx claude-resume-hub --help       # all options
 ```
 
 Prefer a permanent command? `npm i -g claude-resume-hub` gives you `crh --web`.
 **Always up to date:** `npx claude-resume-hub@latest` pulls the newest version automatically.
+**No Node?** Grab a standalone **.exe** from the [latest release](https://github.com/IbrahimKalemci/claude-resume-hub/releases) (Windows/macOS/Linux). It still needs the `claude` CLI on your PATH.
 
 ---
 
@@ -94,14 +97,17 @@ Hepsi bu. Kurulum yok, ayar yok. **Windows, macOS ve Linux**'ta çalışır.
 ```bash
 npx claude-resume-hub              # panelsiz, sadece otomatik devam
 npx claude-resume-hub --web        # panel + bildirim
-npx claude-resume-hub -t "tüm testleri çalıştır ve hataları düzelt"   # görev başlat
+npx claude-resume-hub --tray       # arka planda sistem tepsisi ikonu (Windows)
+npx claude-resume-hub -t "tüm testleri çalıştır ve hataları düzelt"   # YENİ session başlat (devam DEĞİL)
 npx claude-resume-hub --list       # bu projenin session'larını listele (+ id'leri)
+npx claude-resume-hub --web --smart # bağlam-farkında devam (kaldığın adımdan sürer)
 npx claude-resume-hub -s <id>      # belirli bir session'ı devam ettir
 npx claude-resume-hub --help       # tüm seçenekler
 ```
 
 Kalıcı komut ister misin? `npm i -g claude-resume-hub` sana `crh --web` verir.
 **Hep güncel:** `npx claude-resume-hub@latest` otomatik en yeni sürümü çeker.
+**Node yok mu?** [Son sürümden](https://github.com/IbrahimKalemci/claude-resume-hub/releases) standalone **.exe** indir (Windows/macOS/Linux). Yine de `claude` CLI'ın PATH'te olması gerekir.
 
 ---
 

package/bin/cli.js

@@ -23,7 +23,9 @@ function parseArgs(argv) {
     maxCycles: 100,
     verbose: false,
     list: false,
+    smart: false,
     web: false,
+    tray: false,
     port: 4177,
     open: true,
     passthrough: [],
@@ -44,7 +46,9 @@ function parseArgs(argv) {
       case "--poll": opts.poll = parseInt(next(), 10); break;
       case "-m": case "--max-cycles": opts.maxCycles = parseInt(next(), 10); break;
       case "-l": case "--list": opts.list = true; break;
+      case "--smart": opts.smart = true; break;
       case "-w": case "--web": opts.web = true; break;
+      case "--tray": opts.tray = true; opts.web = true; break;
       case "--port": opts.port = parseInt(next(), 10); break;
       case "--no-open": opts.open = false; break;
       case "--verbose": opts.verbose = true; break;
@@ -69,8 +73,9 @@ USAGE
 
 OPTIONS
   -p, --prompt <text>     Message sent to continue after a reset (default: "continue")
-  -t, --task <text>       Initial task; starts a fresh session on the first run,
-                          then continues it. Omit to attach to the most recent session.
+  -t, --task <text>       Start a NEW session with this task (NOT for resuming an
+                          existing one). To continue your stopped session, omit -t
+                          and use plain run / --smart / --session instead.
   -s, --session <id>      Resume a specific session id (instead of the most recent).
                           Find ids by running: claude --resume
   -d, --dir <path>        Working directory / project (default: current dir)
@@ -78,7 +83,12 @@ OPTIONS
       --poll <minutes>    Retry interval if a reset time can't be determined (default: 5)
   -m, --max-cycles <n>    Max limit->wait->continue cycles (default: 100)
   -l, --list              List Claude Code sessions in this project and exit
+      --smart             Context-aware resume: reads the session's last step and
+                          nudges Claude to pick up exactly there (instead of a bare
+                          "continue"). Reads the transcript locally; no AI/network.
   -w, --web               Open a live dashboard (countdown + desktop alerts)
+      --tray              Run a system-tray icon (Windows; implies --web). On
+                          macOS/Linux this falls back to the browser dashboard.
       --port <n>          Dashboard port (default: 4177)
       --no-open           Don't auto-open the browser for the dashboard
       --verbose           Print detection diagnostics
@@ -88,7 +98,9 @@ OPTIONS
 EXAMPLES
   claude-resume-hub                 # keep the latest session going across resets
   claude-resume-hub --web           # ...with a live dashboard + desktop alerts
+  claude-resume-hub --tray          # background system-tray icon (Windows)
   claude-resume-hub --list          # see this project's sessions and their ids
+  claude-resume-hub --web --smart   # context-aware resume (picks up your last step)
   claude-resume-hub -s <id>         # resume a specific session id
   claude-resume-hub -t "run all the tests and fix failures"
   claude-resume-hub -- --model opus # forward flags to claude
@@ -128,7 +140,47 @@ async function main() {
     process.exit(0);
   }
 
+  // --task starts a fresh session; warn so people don't use it expecting a resume.
+  if (opts.task) {
+    console.log(`${C.yellow}[auto-resume] Note: --task starts a NEW session with this task — it does NOT resume an existing one.${C.reset}`);
+    console.log(`${C.dim}   To continue your existing (stopped) session instead, run without -t:  claude-resume-hub --smart   (or pick one with --list / --session)${C.reset}`);
+  }
+
+  // Pin the target session up front so every cycle resumes the SAME conversation.
+  // Plain "-c" means "most recent by mtime" and can silently switch to the wrong
+  // session (the tool's own prior run, or a second terminal). Resolving + pinning
+  // a concrete id, and printing it, makes resume predictable.
+  if (!opts.session && !opts.task) {
+    const { pickActiveSession } = require("../lib/sessions");
+    const active = pickActiveSession(opts.dir);
+    if (active) {
+      opts.session = active.id;
+      console.log(`${C.cyan}[auto-resume]${C.reset} Resuming session ${C.green}${active.id}${C.reset}`);
+      console.log(`${C.dim}   last activity ${active.mtime.toLocaleString()} · ${active.turns} prompts${active.preview ? ` · "${active.preview.slice(0, 48)}…"` : ""}${C.reset}`);
+      console.log(`${C.dim}   not this one? →  claude-resume-hub --list   then   --session <id>${C.reset}`);
+    } else {
+      console.log(`${C.dim}[auto-resume] No prior session found here — will use "claude -c" (most recent).${C.reset}`);
+    }
+  }
+
+  // --smart: build a context-aware resume prompt from the session's last step.
+  if (opts.smart && !opts.task) {
+    const { sessionRecap } = require("../lib/sessions");
+    const recap = sessionRecap(opts.dir);
+    if (recap) {
+      opts.prompt =
+        `Continue where you left off and finish the task you were working on. ` +
+        `If it is already complete, say so instead of inventing new work. ` +
+        `For context, your last message was: "${recap.slice(0, 300)}${recap.length > 300 ? "…" : ""}"`;
+      console.log(`${C.dim}[auto-resume] smart mode: resuming with context from your last step.${C.reset}`);
+    } else {
+      console.log(`${C.dim}[auto-resume] smart mode: no prior session found — using plain "continue".${C.reset}`);
+    }
+  }
+
   const engine = new AutoResumeEngine(opts);
+  let trayChild = null;
+  const cleanup = () => { if (trayChild) { try { trayChild.kill(); } catch {} trayChild = null; } };
 
   // Colorize a few known log lines for the terminal.
   engine.on("log", (line) => {
@@ -141,17 +193,28 @@ async function main() {
   engine.on("output", (chunk) => process.stdout.write(chunk));
 
   if (opts.web) {
-    const { url, error } = await startDashboard(engine, { port: opts.port, open: opts.open });
-    if (url) console.log(`${C.green}[auto-resume]${C.reset} Dashboard: ${url}  (leave it open for desktop alerts)`);
-    else console.log(`${C.red}[auto-resume]${C.reset} Could not start dashboard: ${error && error.message}`);
+    // When running the tray, don't also pop a browser tab — the tray is the UI.
+    const { url, error } = await startDashboard(engine, { port: opts.port, open: opts.open && !opts.tray });
+    if (url) {
+      console.log(`${C.green}[auto-resume]${C.reset} Dashboard: ${url}  (leave it open for desktop alerts)`);
+      if (opts.tray) {
+        const { startTray } = require("../lib/tray");
+        const t = startTray(url);
+        if (t.ok) { trayChild = t.child; console.log(`${C.green}[auto-resume]${C.reset} Tray icon started — check your system tray; right-click for options.`); }
+        else console.log(`${C.yellow}[auto-resume]${C.reset} Tray unavailable (${t.reason}); the dashboard is still at ${url}`);
+      }
+    } else {
+      console.log(`${C.red}[auto-resume]${C.reset} Could not start dashboard: ${error && error.message}`);
+    }
   }
 
-  process.on("SIGINT", () => { console.log("\n[auto-resume] Interrupted. Bye."); engine.stop(); process.exit(130); });
+  process.on("SIGINT", () => { console.log("\n[auto-resume] Interrupted. Bye."); cleanup(); engine.stop(); process.exit(130); });
 
   const result = await engine.run();
-  // Keep the process (and dashboard) alive briefly so the browser sees the final state.
-  if (opts.web) setTimeout(() => process.exit(result.code), 1500);
-  else process.exit(result.code);
+  // Keep the process (and dashboard) alive briefly so the browser sees the final
+  // state; the tray self-exits once /status stops responding, but kill it too.
+  if (opts.web) setTimeout(() => { cleanup(); process.exit(result.code); }, 1500);
+  else { cleanup(); process.exit(result.code); }
 }
 
 main().catch((err) => { console.error("[auto-resume] Fatal:", err); process.exit(1); });

package/lib/dashboard.js

@@ -43,6 +43,12 @@ function startDashboard(engine, { port = 4177, open = true } = {}) {
       req.on("close", () => clients.delete(res));
       return;
     }
+    if (req.url === "/status") {
+      // Lightweight JSON snapshot for pollers (e.g. the --tray shim).
+      res.writeHead(200, { "Content-Type": "application/json", "Cache-Control": "no-cache" });
+      res.end(JSON.stringify(engine.state));
+      return;
+    }
     res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
     res.end(PAGE);
   });

package/lib/detect.js

@@ -36,7 +36,7 @@ function detectLimit(text) {
  * "resets Mon 12:00am". Best-effort fallback; the epoch marker is authoritative.
  * Returns a Date (local) or null.
  */
-function parseClockTime(text) {
+function parseClockTime(text, now = new Date()) {
   const m = text.match(
     /reset(?:s|\s+at)?\s+(?:(Mon|Tue|Wed|Thu|Fri|Sat|Sun)\s+)?(\d{1,2})(?::(\d{2}))?\s*(am|pm)/i
   );
@@ -49,7 +49,6 @@ function parseClockTime(text) {
   if (ap === "pm" && h < 12) h += 12;
   if (ap === "am" && h === 12) h = 0;
 
-  const now = new Date();
   const target = new Date(now);
   target.setHours(h, min, 0, 0);
 

package/lib/sessions.js

@@ -64,7 +64,12 @@ function listSessions(dir) {
     } catch {
       st = { mtime: new Date(0), size: 0 };
     }
-    const turns = lines.reduce((n, l) => n + (/"type":"(user|assistant)"/.test(l) ? 1 : 0), 0);
+    // Count real human prompts (a "user" line that isn't a tool_result echo),
+    // not every message line — otherwise tool traffic inflates the number.
+    const turns = lines.reduce(
+      (n, l) => n + (/"type":"user"/.test(l) && !/"tool_result"/.test(l) ? 1 : 0),
+      0
+    );
     return {
       id: f.replace(/\.jsonl$/, ""),
       mtime: st.mtime,
@@ -78,4 +83,56 @@ function listSessions(dir) {
   return out;
 }
 
-module.exports = { projectsRoot, encodeDir, findProjectFolder, listSessions };
+/** Last non-empty assistant text in a transcript — used as a resume recap. */
+function lastAssistantText(lines) {
+  for (let i = lines.length - 1; i >= 0; i--) {
+    try {
+      const o = JSON.parse(lines[i]);
+      if (o.type === "assistant" && o.message) {
+        let c = o.message.content;
+        if (Array.isArray(c)) c = c.filter((x) => x && x.type === "text").map((x) => x.text).join(" ");
+        if (typeof c === "string" && c.trim()) return c.trim().replace(/\s+/g, " ");
+      }
+    } catch { /* ignore malformed lines */ }
+  }
+  return "";
+}
+
+/**
+ * Recap of the most-recent session in `dir`: the last thing the assistant said.
+ * Used by --smart to build a context-aware resume prompt. Returns "" if none.
+ */
+function sessionRecap(dir) {
+  const folder = findProjectFolder(dir);
+  if (!folder) return "";
+  let files = [];
+  try { files = fs.readdirSync(folder).filter((f) => f.endsWith(".jsonl")); } catch { return ""; }
+  let newest = null, newestM = -1;
+  for (const f of files) {
+    try {
+      const m = fs.statSync(path.join(folder, f)).mtimeMs;
+      if (m > newestM) { newestM = m; newest = f; }
+    } catch { /* skip */ }
+  }
+  if (!newest) return "";
+  try {
+    const lines = fs.readFileSync(path.join(folder, newest), "utf8").split("\n").filter(Boolean);
+    return lastAssistantText(lines);
+  } catch { return ""; }
+}
+
+/**
+ * The session to resume by default in `dir`: the most recently active one.
+ * Returned object is the same shape as listSessions() entries, or null.
+ * The engine PINS this id so later cycles don't race "most recent" (which can
+ * change if the tool's own run, or a second terminal, touches another session).
+ */
+function pickActiveSession(dir) {
+  const all = listSessions(dir);
+  return all.length ? all[0] : null;
+}
+
+module.exports = {
+  projectsRoot, encodeDir, findProjectFolder, listSessions,
+  lastAssistantText, sessionRecap, pickActiveSession,
+};

package/lib/tray.js

@@ -0,0 +1,106 @@
+"use strict";
+
+const { spawn } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+/**
+ * A genuine Windows system-tray icon with ZERO bundled dependencies: a tiny
+ * PowerShell + System.Windows.Forms.NotifyIcon shim that rides the .NET already
+ * present on every Windows 10/11 machine. It polls the dashboard's /status
+ * endpoint, colours the tray icon by phase, and pops a balloon on phase changes.
+ * On macOS/Linux there is no zero-dep native tray in pure Node — callers should
+ * fall back to the browser dashboard.
+ */
+
+// NOTE: written as a plain string (no backticks / no ${...}) so it survives the
+// JS template and PowerShell parsing cleanly.
+const PS_SCRIPT = [
+  'param([string]$Url)',
+  'Add-Type -AssemblyName System.Windows.Forms',
+  'Add-Type -AssemblyName System.Drawing',
+  '',
+  'function New-DotIcon([System.Drawing.Color]$color) {',
+  '  $bmp = New-Object System.Drawing.Bitmap 16,16',
+  '  $g = [System.Drawing.Graphics]::FromImage($bmp)',
+  "  $g.SmoothingMode = 'AntiAlias'",
+  '  $g.Clear([System.Drawing.Color]::Transparent)',
+  '  $brush = New-Object System.Drawing.SolidBrush $color',
+  '  $g.FillEllipse($brush, 2, 2, 12, 12)',
+  '  $g.Dispose()',
+  '  return [System.Drawing.Icon]::FromHandle($bmp.GetHicon())',
+  '}',
+  '',
+  '$colors = @{',
+  '  starting = [System.Drawing.Color]::FromArgb(201,100,66)',
+  '  running  = [System.Drawing.Color]::FromArgb(201,100,66)',
+  '  waiting  = [System.Drawing.Color]::FromArgb(210,153,34)',
+  '  done     = [System.Drawing.Color]::FromArgb(63,185,80)',
+  '  error    = [System.Drawing.Color]::FromArgb(248,81,73)',
+  '}',
+  '',
+  '$ni = New-Object System.Windows.Forms.NotifyIcon',
+  '$ni.Icon = New-DotIcon $colors.starting',
+  '$ni.Text = "claude-resume-hub"',
+  '$ni.Visible = $true',
+  '',
+  '$menu = New-Object System.Windows.Forms.ContextMenuStrip',
+  '$open = $menu.Items.Add("Open dashboard")',
+  '$open.add_Click({ Start-Process $Url })',
+  '$quit = $menu.Items.Add("Quit tray")',
+  '$quit.add_Click({ $ni.Visible = $false; $ni.Dispose(); [System.Windows.Forms.Application]::Exit() })',
+  '$ni.ContextMenuStrip = $menu',
+  '$ni.add_MouseClick({ param($s,$e) if ($e.Button -eq [System.Windows.Forms.MouseButtons]::Left) { Start-Process $Url } })',
+  '',
+  '$script:last = ""',
+  '$script:fails = 0',
+  '$timer = New-Object System.Windows.Forms.Timer',
+  '$timer.Interval = 2000',
+  '$timer.add_Tick({',
+  '  try {',
+  '    $s = Invoke-RestMethod -Uri ($Url + "/status") -TimeoutSec 3',
+  '    $script:fails = 0',
+  '    $phase = [string]$s.phase',
+  '    $msg = [string]$s.message',
+  '    if ($phase -ne $script:last) {',
+  '      if ($colors.ContainsKey($phase)) { $ni.Icon = New-DotIcon $colors[$phase] }',
+  '      $t = "claude-resume-hub - " + $phase',
+  '      if ($t.Length -gt 63) { $t = $t.Substring(0,63) }',
+  '      $ni.Text = $t',
+  '      if ($script:last -ne "") { $ni.ShowBalloonTip(4000, "claude-resume-hub", $msg, [System.Windows.Forms.ToolTipIcon]::Info) }',
+  '      $script:last = $phase',
+  '    }',
+  '  } catch {',
+  '    $script:fails = $script:fails + 1',
+  '    if ($script:fails -ge 6) { $ni.Visible = $false; $ni.Dispose(); [System.Windows.Forms.Application]::Exit() }',
+  '  }',
+  '})',
+  '$timer.Start()',
+  '',
+  '[System.Windows.Forms.Application]::Run((New-Object System.Windows.Forms.ApplicationContext))',
+  '',
+].join("\n");
+
+function startTray(url) {
+  if (process.platform !== "win32") {
+    return { ok: false, reason: "native tray is Windows-only — use the --web dashboard on macOS/Linux" };
+  }
+  try {
+    const file = path.join(os.tmpdir(), `crh-tray-${process.pid}.ps1`);
+    fs.writeFileSync(file, PS_SCRIPT, "utf8");
+    // -STA is REQUIRED: WinForms' message loop / Timer won't pump in MTA.
+    // Do NOT use detached:true — a detached process's message pump doesn't run,
+    // so the tray never updates. windowsHide hides the console window instead.
+    const child = spawn(
+      "powershell",
+      ["-NoProfile", "-STA", "-WindowStyle", "Hidden", "-ExecutionPolicy", "Bypass", "-File", file, url],
+      { stdio: "ignore", windowsHide: true }
+    );
+    return { ok: true, file, pid: child.pid, child };
+  } catch (e) {
+    return { ok: false, reason: e.message };
+  }
+}
+
+module.exports = { startTray, PS_SCRIPT };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-resume-hub",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Run Claude Code and auto-continue the moment a usage/session limit resets — with a live dashboard and desktop alerts. Cross-platform, zero-dependency.",
   "bin": {
     "claude-resume-hub": "bin/cli.js",
@@ -18,7 +18,9 @@
   ],
   "scripts": {
     "start": "node bin/cli.js",
-    "test": "node --test"
+    "test": "node --test",
+    "build:bundle": "esbuild bin/cli.js --bundle --platform=node --target=node20 --format=cjs --outfile=dist/bundle.cjs",
+    "build:exe": "node scripts/build-exe.js"
   },
   "keywords": [
     "claude",
@@ -41,5 +43,8 @@
   "bugs": {
     "url": "https://github.com/IbrahimKalemci/claude-resume-hub/issues"
   },
-  "homepage": "https://github.com/IbrahimKalemci/claude-resume-hub#readme"
+  "homepage": "https://github.com/IbrahimKalemci/claude-resume-hub#readme",
+  "devDependencies": {
+    "esbuild": "^0.28.1"
+  }
 }