@yyyeader/claude-recall 1.0.0 → 1.1.0

package/README.md

@@ -7,9 +7,9 @@
     Search, find, and resume any Claude Code conversation across all your projects — instantly.
   </p>
   <p align="center">
-    <a href="https://www.npmjs.com/package/claude-recall"><img src="https://img.shields.io/npm/v/claude-recall.svg" alt="npm version"></a>
-    <a href="https://github.com/yyyeader/claude-recall/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/claude-recall.svg" alt="license"></a>
-    <a href="https://www.npmjs.com/package/claude-recall"><img src="https://img.shields.io/npm/dm/claude-recall.svg" alt="downloads"></a>
+    <a href="https://www.npmjs.com/package/@yyyeader/claude-recall"><img src="https://img.shields.io/npm/v/@yyyeader/claude-recall.svg" alt="npm version"></a>
+    <a href="https://github.com/yyyeader/claude-recall/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@yyyeader/claude-recall.svg" alt="license"></a>
+    <a href="https://www.npmjs.com/package/@yyyeader/claude-recall"><img src="https://img.shields.io/npm/dm/@yyyeader/claude-recall.svg" alt="downloads"></a>
   </p>
 </p>
 
@@ -31,7 +31,7 @@ You know the session exists somewhere in `~/.claude/projects/`, but good luck fi
 ## The Solution
 
 ```bash
-npm install -g claude-recall
+npm install -g @yyyeader/claude-recall
 ```
 
 ```bash
@@ -47,7 +47,7 @@ claude-recall -j | jq        # Pipe JSON to your own tools
 ### 1. Install
 
 ```bash
-npm install -g claude-recall
+npm install -g @yyyeader/claude-recall
 ```
 
 ### 2. Add the shell wrapper (recommended)
@@ -82,7 +82,7 @@ Want to search sessions from *inside* Claude Code?
 # Install the slash command
 claude-recall-install
 # Or manually:
-cp node_modules/claude-recall/commands/recall.md ~/.claude/commands/
+cp node_modules/@yyyeader/claude-recall/commands/recall.md ~/.claude/commands/
 ```
 
 Then:

package/bin/claude-recall.js

@@ -11,7 +11,7 @@ const args = process.argv.slice(2);
 const flags = {
   list: false,
   json: false,
-  limit: 50,
+  limit: 0,
   project: null,
   help: false,
   keyword: [],
@@ -55,7 +55,7 @@ Usage:
   claude-recall -l [keyword]       List sessions (no interaction)
   claude-recall -j [keyword]       Output as JSON
   claude-recall -p <project>       Filter by project name
-  claude-recall -n <number>        Limit results (default: 50)
+  claude-recall -n <number>        Limit results (default: all)
 
 Options:
   -l, --list       List mode (no fzf)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yyyeader/claude-recall",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Search and resume Claude Code sessions across all projects",
   "main": "src/index.js",
   "bin": {

package/src/scanner.js

@@ -1,4 +1,4 @@
-import { readdirSync, statSync } from "node:fs";
+import { readdirSync, readFileSync, statSync, existsSync } from "node:fs";
 import { join, basename } from "node:path";
 import { homedir } from "node:os";
 import { resolvePath } from "./resolver.js";
@@ -8,7 +8,8 @@ const CLAUDE_DIR = join(homedir(), ".claude", "projects");
 
 /**
  * Scan all Claude Code sessions across all projects.
- * Returns an array of session objects sorted by modification time (newest first).
+ * Uses sessions-index.json when available (fast path),
+ * falls back to JSONL parsing for older projects.
  */
 export async function scanSessions({ keyword, project, limit } = {}) {
   let projectDirs;
@@ -25,8 +26,46 @@ export async function scanSessions({ keyword, project, limit } = {}) {
   for (const dir of projectDirs) {
     const projectEncoded = dir.name;
     const projectPath = join(CLAUDE_DIR, projectEncoded);
+    const indexFile = join(projectPath, "sessions-index.json");
 
-    // List JSONL files directly under the project dir (skip subagents)
+    // Fast path: use sessions-index.json
+    if (existsSync(indexFile)) {
+      try {
+        const index = JSON.parse(readFileSync(indexFile, "utf8"));
+        for (const entry of index.entries || []) {
+          const workDir = entry.projectPath || resolvePath(projectEncoded);
+
+          if (project) {
+            const pl = project.toLowerCase();
+            if (
+              !workDir.toLowerCase().includes(pl) &&
+              !projectEncoded.toLowerCase().includes(pl)
+            ) {
+              continue;
+            }
+          }
+
+          sessions.push({
+            sessionId: entry.sessionId,
+            projectEncoded,
+            workDir,
+            filePath: entry.fullPath,
+            modifiedAt: new Date(entry.modified || entry.fileMtime),
+            summary:
+              [entry.firstPrompt, entry.summary].filter(Boolean).join(" — ") ||
+              "",
+            messageCount: entry.messageCount || 0,
+            gitBranch: entry.gitBranch || "",
+            fromIndex: true,
+          });
+        }
+      } catch {
+        // Fall through to JSONL scan
+      }
+      continue;
+    }
+
+    // Fallback: scan JSONL files directly
     let files;
     try {
       files = readdirSync(projectPath)
@@ -36,33 +75,13 @@ export async function scanSessions({ keyword, project, limit } = {}) {
       continue;
     }
 
-    // Also check one level deeper for session directories (session-id/session.jsonl pattern)
-    try {
-      const subdirs = readdirSync(projectPath, { withFileTypes: true }).filter(
-        (d) => d.isDirectory() && d.name !== "subagents"
-      );
-      for (const subdir of subdirs) {
-        try {
-          const subFiles = readdirSync(join(projectPath, subdir.name))
-            .filter((f) => f.endsWith(".jsonl"))
-            .map((f) => join(projectPath, subdir.name, f));
-          files.push(...subFiles);
-        } catch {
-          // skip
-        }
-      }
-    } catch {
-      // skip
-    }
-
     const workDir = resolvePath(projectEncoded);
 
-    // Filter by project name if specified
     if (project) {
-      const projectLower = project.toLowerCase();
+      const pl = project.toLowerCase();
       if (
-        !projectEncoded.toLowerCase().includes(projectLower) &&
-        !workDir.toLowerCase().includes(projectLower)
+        !projectEncoded.toLowerCase().includes(pl) &&
+        !workDir.toLowerCase().includes(pl)
       ) {
         continue;
       }
@@ -72,8 +91,6 @@ export async function scanSessions({ keyword, project, limit } = {}) {
       try {
         const stat = statSync(file);
         const sessionId = basename(file, ".jsonl");
-
-        // Skip subagent files
         if (file.includes("/subagents/")) continue;
 
         sessions.push({
@@ -82,6 +99,7 @@ export async function scanSessions({ keyword, project, limit } = {}) {
           workDir,
           filePath: file,
           modifiedAt: stat.mtime,
+          fromIndex: false,
         });
       } catch {
         // skip
@@ -92,26 +110,33 @@ export async function scanSessions({ keyword, project, limit } = {}) {
   // Sort by modification time, newest first
   sessions.sort((a, b) => b.modifiedAt - a.modifiedAt);
 
-  // Extract summaries (in parallel, batched)
-  const batch = limit ? sessions.slice(0, limit) : sessions;
-  await Promise.all(
-    batch.map(async (s) => {
-      s.summary = await extractSummary(s.filePath);
-    })
-  );
+  // Extract summaries for sessions that don't have one (JSONL fallback)
+  const needsSummary = sessions.filter((s) => !s.fromIndex);
+  if (needsSummary.length > 0) {
+    await Promise.all(
+      needsSummary.map(async (s) => {
+        s.summary = await extractSummary(s.filePath);
+      })
+    );
+  }
 
-  // Filter by keyword if specified
-  let result = batch;
+  // Filter by keyword
+  let result = sessions;
   if (keyword) {
     const kw = keyword.toLowerCase();
-    result = batch.filter(
+    result = sessions.filter(
       (s) =>
-        s.summary.toLowerCase().includes(kw) ||
+        (s.summary || "").toLowerCase().includes(kw) ||
         s.workDir.toLowerCase().includes(kw) ||
         s.projectEncoded.toLowerCase().includes(kw) ||
-        s.sessionId.toLowerCase().includes(kw)
+        s.sessionId.toLowerCase().includes(kw) ||
+        (s.gitBranch || "").toLowerCase().includes(kw)
     );
   }
 
+  if (limit) {
+    result = result.slice(0, limit);
+  }
+
   return result;
 }