claude-resume-hub 1.0.0 → 1.2.0

package/README.md

@@ -7,13 +7,14 @@
 
 <p align="center">
   <a href="https://www.npmjs.com/package/claude-resume-hub"><img src="https://img.shields.io/npm/v/claude-resume-hub?color=c96442" alt="npm"></a>
+  <a href="https://github.com/IbrahimKalemci/claude-resume-hub/actions/workflows/ci.yml"><img src="https://github.com/IbrahimKalemci/claude-resume-hub/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <img src="https://img.shields.io/badge/node-%3E%3D16-3fb950" alt="node >= 16">
   <img src="https://img.shields.io/badge/Windows%20%7C%20macOS%20%7C%20Linux-8b93a7" alt="platforms">
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT"></a>
 </p>
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/IbrahimKalemci/claude-resume-hub/main/docs/dashboard.svg" alt="live dashboard with a big countdown, status and streaming log" width="620">
+  <img src="https://raw.githubusercontent.com/IbrahimKalemci/claude-resume-hub/main/docs/demo.svg" alt="countdown reaching zero, then sending continue to Claude to resume the task" width="700">
 </p>
 
 <p align="center"><b>🇬🇧 <a href="#-english">English</a> &nbsp;·&nbsp; 🇹🇷 <a href="#-türkçe">Türkçe</a></b></p>
@@ -52,10 +53,13 @@ That's it. No install, no config. It works on **Windows, macOS and Linux**.
 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 --list       # list this project's sessions (+ their ids)
+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.
 
 ---
 
@@ -91,10 +95,25 @@ Hepsi bu. Kurulum yok, ayar yok. **Windows, macOS ve Linux**'ta çalışır.
 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 --list       # bu projenin session'larını listele (+ id'leri)
+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.
+
+---
+
+## 🛠️ From source · Kaynaktan
+
+Prefer to run it straight from the repo (no npm)? / npm'siz, doğrudan repodan mı çalıştırmak istiyorsun?
+
+```bash
+git clone https://github.com/IbrahimKalemci/claude-resume-hub.git
+cd claude-resume-hub
+node bin/cli.js --web
+```
 
 ---
 

package/bin/cli.js

@@ -16,11 +16,13 @@ function parseArgs(argv) {
   const opts = {
     prompt: "continue",
     task: null,
+    session: null,
     dir: process.cwd(),
     buffer: 30,
     poll: 5,
     maxCycles: 100,
     verbose: false,
+    list: false,
     web: false,
     port: 4177,
     open: true,
@@ -36,10 +38,12 @@ function parseArgs(argv) {
     switch (a) {
       case "-p": case "--prompt": opts.prompt = next(); break;
       case "-t": case "--task": opts.task = next(); break;
+      case "-s": case "--session": opts.session = next(); break;
       case "-d": case "--dir": opts.dir = next(); break;
       case "-b": case "--buffer": opts.buffer = parseInt(next(), 10); break;
       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 "-w": case "--web": opts.web = true; break;
       case "--port": opts.port = parseInt(next(), 10); break;
       case "--no-open": opts.open = false; break;
@@ -67,10 +71,13 @@ 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.
+  -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)
   -b, --buffer <seconds>  Safety margin added after the reset time (default: 30)
       --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
   -w, --web               Open a live dashboard (countdown + desktop alerts)
       --port <n>          Dashboard port (default: 4177)
       --no-open           Don't auto-open the browser for the dashboard
@@ -81,6 +88,8 @@ 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 --list          # see this project's sessions and their ids
+  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
 `);
@@ -89,8 +98,36 @@ EXAMPLES
 const C = { cyan: "\x1b[36m", dim: "\x1b[2m", green: "\x1b[32m", yellow: "\x1b[33m", red: "\x1b[31m", reset: "\x1b[0m" };
 const stamp = () => new Date().toLocaleString();
 
+function printSessions(dir) {
+  const { listSessions, findProjectFolder } = require("../lib/sessions");
+  if (!findProjectFolder(dir)) {
+    console.log(`No Claude Code sessions found for:\n  ${dir}`);
+    console.log(`${C.dim}(Looked in ~/.claude/projects. Run this in your project folder, or pass -d <path>.)${C.reset}`);
+    return;
+  }
+  const sessions = listSessions(dir);
+  if (!sessions.length) { console.log("No sessions in this project yet."); return; }
+
+  console.log(`\nClaude Code sessions for ${C.cyan}${dir}${C.reset}  ${C.dim}(newest first)${C.reset}\n`);
+  sessions.forEach((s, i) => {
+    const dot = i === 0 ? `${C.green}●${C.reset}` : " ";
+    console.log(`${dot} ${s.id}`);
+    console.log(`   ${C.dim}${s.mtime.toLocaleString()} · ${s.turns} turns · ${s.sizeKB} KB${C.reset}`);
+    if (s.preview) console.log(`   ${C.dim}"${s.preview}${s.preview.length >= 80 ? "…" : ""}"${C.reset}`);
+    console.log("");
+  });
+  console.log(`${C.green}●${C.reset} ${C.dim}= what plain "continue" (-c) resumes (the most recent).${C.reset}`);
+  console.log(`${C.dim}Resume a specific one:  ${C.reset}crh --session <id>`);
+}
+
 async function main() {
   const opts = parseArgs(process.argv.slice(2));
+
+  if (opts.list) {
+    printSessions(opts.dir);
+    process.exit(0);
+  }
+
   const engine = new AutoResumeEngine(opts);
 
   // Colorize a few known log lines for the terminal.

package/lib/engine.js

@@ -4,6 +4,23 @@ const { spawn } = require("child_process");
 const { EventEmitter } = require("events");
 const { detectLimit, fmtDuration } = require("./detect");
 
+/**
+ * Build the argument list passed to `claude` for a given cycle.
+ *   - First cycle with an initial task  -> start a fresh session with that task
+ *   - A specific session id (--session) -> resume exactly that session
+ *   - Otherwise                         -> continue the most recent session (-c)
+ */
+function buildClaudeArgs(opts, cycle) {
+  const extra = opts.passthrough || [];
+  if (cycle === 1 && opts.task) {
+    return ["-p", opts.task, ...extra];
+  }
+  if (opts.session) {
+    return ["--resume", opts.session, "-p", opts.prompt, ...extra];
+  }
+  return ["-c", "-p", opts.prompt, ...extra];
+}
+
 /**
  * AutoResumeEngine runs Claude Code in a loop, waiting out usage limits.
  *
@@ -88,12 +105,10 @@ class AutoResumeEngine extends EventEmitter {
     const o = this.opts;
     this.log(`Starting. dir="${o.dir}"  prompt="${o.prompt}"`);
     if (o.task) this.log(`Initial task: "${o.task}"`);
+    if (o.session) this.log(`Resuming session: ${o.session}`);
 
     for (let cycle = 1; cycle <= o.maxCycles && !this._stopped; cycle++) {
-      const claudeArgs =
-        cycle === 1 && o.task
-          ? ["-p", o.task, ...o.passthrough]
-          : ["-c", "-p", o.prompt, ...o.passthrough];
+      const claudeArgs = buildClaudeArgs(o, cycle);
 
       this._setState({ phase: "running", cycle, resetAt: null, wakeAt: null, message: "Running Claude…" });
       this.log(`Cycle ${cycle}/${o.maxCycles} — running claude…`);
@@ -143,4 +158,4 @@ class AutoResumeEngine extends EventEmitter {
   }
 }
 
-module.exports = { AutoResumeEngine };
+module.exports = { AutoResumeEngine, buildClaudeArgs };

package/lib/sessions.js

@@ -0,0 +1,81 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+/** Root where Claude Code stores per-project session transcripts. */
+function projectsRoot() {
+  return path.join(os.homedir(), ".claude", "projects");
+}
+
+/**
+ * Encode an absolute directory the way Claude Code names its project folders:
+ * the path with `:`, `/` and `\` all replaced by `-`.
+ * e.g. C:\Users\me\proj -> C--Users-me-proj
+ */
+function encodeDir(dir) {
+  return path.resolve(dir).replace(/[/\\:]/g, "-");
+}
+
+/** Locate the project folder for `dir` (exact, then case-insensitive). */
+function findProjectFolder(dir) {
+  const root = projectsRoot();
+  if (!fs.existsSync(root)) return null;
+  const want = encodeDir(dir);
+  let entries = [];
+  try { entries = fs.readdirSync(root); } catch { return null; }
+  if (entries.includes(want)) return path.join(root, want);
+  const ci = entries.find((e) => e.toLowerCase() === want.toLowerCase());
+  return ci ? path.join(root, ci) : null;
+}
+
+/** First non-empty user message in a transcript — used as a preview. */
+function firstUserMessage(lines) {
+  for (const l of lines) {
+    try {
+      const o = JSON.parse(l);
+      if (o.type === "user" && o.message) {
+        let c = o.message.content;
+        if (Array.isArray(c)) c = c.map((x) => (x && x.text) || "").join(" ");
+        if (typeof c === "string" && c.trim()) return c.trim().replace(/\s+/g, " ");
+      }
+    } catch { /* ignore malformed lines */ }
+  }
+  return "";
+}
+
+/**
+ * List Claude Code sessions for a project directory, newest first.
+ * Returns [{ id, mtime, sizeKB, turns, preview }].
+ */
+function listSessions(dir) {
+  const folder = findProjectFolder(dir);
+  if (!folder) return [];
+  let files = [];
+  try { files = fs.readdirSync(folder).filter((f) => f.endsWith(".jsonl")); } catch { return []; }
+
+  const out = files.map((f) => {
+    const full = path.join(folder, f);
+    let st, lines = [];
+    try {
+      st = fs.statSync(full);
+      lines = fs.readFileSync(full, "utf8").split("\n").filter(Boolean);
+    } catch {
+      st = { mtime: new Date(0), size: 0 };
+    }
+    const turns = lines.reduce((n, l) => n + (/"type":"(user|assistant)"/.test(l) ? 1 : 0), 0);
+    return {
+      id: f.replace(/\.jsonl$/, ""),
+      mtime: st.mtime,
+      sizeKB: Math.round((st.size || 0) / 1024),
+      turns,
+      preview: firstUserMessage(lines).slice(0, 80),
+    };
+  });
+
+  out.sort((a, b) => b.mtime - a.mtime); // newest first
+  return out;
+}
+
+module.exports = { projectsRoot, encodeDir, findProjectFolder, listSessions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-resume-hub",
-  "version": "1.0.0",
+  "version": "1.2.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",