claude-session-skill 1.1.3 → 1.1.5

package/README.md

@@ -2,6 +2,13 @@
 
 A [Claude Code](https://docs.anthropic.com/en/docs/claude-code) skill for searching, browsing, and naming past sessions. Indexes all session history and generates AI summaries so you can find any session by keyword, project, or name.
 
+This package ships two ways to use the same session index:
+
+- **Claude Code skill** — install via `git clone`, use `/session` commands directly in Claude Code
+- **MCP server** — install via `npm`, connect any MCP-compatible client (Claude Desktop, Cursor, etc.)
+
+Both read from the same `~/.claude/` session data. Use whichever fits your workflow.
+
 ## Requirements
 
 - [Bun](https://bun.sh) runtime
@@ -73,6 +80,16 @@ Names are 1–50 characters. Named sessions rank highest in search results. Clea
 | Within 24 hours | 1.5× recency boost |
 | Within 7 days | 1.2× recency boost |
 
+## Resuming sessions
+
+Every session view (list, search, detail) prints a ready-to-run resume command:
+
+```
+Resume:   cd /path/to/project && claude --resume <session-id>
+```
+
+**Why the `cd`?** `claude --resume` is directory-scoped — it only searches for sessions stored under the project folder matching your *current* working directory. Running it from the wrong directory returns `No conversation found` even with a valid session ID. Always run the full `cd ... && claude --resume ...` command as printed.
+
 ## MCP Server
 
 `claude-session-skill` ships a Model Context Protocol (MCP) server so any MCP-compatible client (Claude Desktop, Cursor, etc.) can search sessions without using the CLI skill.

package/dist/mcp-server.js

@@ -15167,6 +15167,9 @@ function formatSessionList(sessions, showAll) {
     if (lastMsg) {
       lines.push(`  Left off: "${truncate(lastMsg, 90)}"`);
     }
+    if (s.cwd) {
+      lines.push(`  Resume:   cd ${s.cwd} && claude --resume ${s.id}`);
+    }
     lines.push("");
   }
   return lines.join(`
@@ -15192,7 +15195,10 @@ function formatSearchResults(sessions, query) {
       lines.push(`  Left off: "${truncate(lastMsg, 90)}"`);
     }
     if (s.gitBranch) {
-      lines.push(`  Branch: ${s.gitBranch}`);
+      lines.push(`  Branch:   ${s.gitBranch}`);
+    }
+    if (s.cwd) {
+      lines.push(`  Resume:   cd ${s.cwd} && claude --resume ${s.id}`);
     }
     lines.push("");
   }
@@ -15223,6 +15229,11 @@ function formatSessionDetail(session) {
     lines.push(`Left off: "${s.lastMessage.slice(0, 300)}"`);
     lines.push("");
   }
+  if (s.cwd) {
+    lines.push(`Resume with:`);
+    lines.push(`  cd ${s.cwd} && claude --resume ${s.id}`);
+    lines.push("");
+  }
   return lines.join(`
 `);
 }

package/dist/session.js

@@ -747,6 +747,9 @@ function formatSessionList(sessions, showAll) {
     if (lastMsg) {
       lines.push(`  Left off: "${truncate(lastMsg, 90)}"`);
     }
+    if (s.cwd) {
+      lines.push(`  Resume:   cd ${s.cwd} && claude --resume ${s.id}`);
+    }
     lines.push("");
   }
   return lines.join(`
@@ -772,7 +775,10 @@ function formatSearchResults(sessions, query) {
       lines.push(`  Left off: "${truncate(lastMsg, 90)}"`);
     }
     if (s.gitBranch) {
-      lines.push(`  Branch: ${s.gitBranch}`);
+      lines.push(`  Branch:   ${s.gitBranch}`);
+    }
+    if (s.cwd) {
+      lines.push(`  Resume:   cd ${s.cwd} && claude --resume ${s.id}`);
     }
     lines.push("");
   }
@@ -803,6 +809,11 @@ function formatSessionDetail(session) {
     lines.push(`Left off: "${s.lastMessage.slice(0, 300)}"`);
     lines.push("");
   }
+  if (s.cwd) {
+    lines.push(`Resume with:`);
+    lines.push(`  cd ${s.cwd} && claude --resume ${s.id}`);
+    lines.push("");
+  }
   return lines.join(`
 `);
 }

package/lib/__tests__/format.test.ts

@@ -64,6 +64,16 @@ describe("formatSessionList", () => {
     const output = formatSessionList([makeSession({ name: "Auth Fix" })], true);
     expect(output).toContain("Auth Fix");
   });
+
+  test("shows resume command in list view", () => {
+    const output = formatSessionList([makeSession()], true);
+    expect(output).toContain("cd /Users/tim/projects/my-project && claude --resume abcdef1234567890");
+  });
+
+  test("omits resume line when cwd is empty in list", () => {
+    const output = formatSessionList([makeSession({ cwd: "" })], true);
+    expect(output).not.toContain("claude --resume");
+  });
 });
 
 describe("formatSearchResults", () => {
@@ -88,6 +98,11 @@ describe("formatSearchResults", () => {
     const output = formatSearchResults([makeSession({ gitBranch: "feat/login" })], "auth");
     expect(output).toContain("feat/login");
   });
+
+  test("shows resume command in search results", () => {
+    const output = formatSearchResults([makeSession()], "auth");
+    expect(output).toContain("cd /Users/tim/projects/my-project && claude --resume abcdef1234567890");
+  });
 });
 
 describe("formatSessionDetail", () => {
@@ -130,6 +145,16 @@ describe("formatSessionDetail", () => {
     const output = formatSessionDetail(makeSession({ gitBranch: "" }));
     expect(output).not.toContain("Branch:");
   });
+
+  test("shows resume command with cd and session id", () => {
+    const output = formatSessionDetail(makeSession());
+    expect(output).toContain("cd /Users/tim/projects/my-project && claude --resume abcdef1234567890");
+  });
+
+  test("omits resume line when cwd is empty", () => {
+    const output = formatSessionDetail(makeSession({ cwd: "" }));
+    expect(output).not.toContain("claude --resume");
+  });
 });
 
 describe("formatStats", () => {

package/lib/format.ts

@@ -75,6 +75,9 @@ export function formatSessionList(sessions: SessionEntry[], showAll: boolean): s
     if (lastMsg) {
       lines.push(`  Left off: "${truncate(lastMsg, 90)}"`);
     }
+    if (s.cwd) {
+      lines.push(`  Resume:   cd ${s.cwd} && claude --resume ${s.id}`);
+    }
     lines.push("");
   }
 
@@ -105,7 +108,10 @@ export function formatSearchResults(sessions: SessionEntry[], query: string): st
       lines.push(`  Left off: "${truncate(lastMsg, 90)}"`);
     }
     if (s.gitBranch) {
-      lines.push(`  Branch: ${s.gitBranch}`);
+      lines.push(`  Branch:   ${s.gitBranch}`);
+    }
+    if (s.cwd) {
+      lines.push(`  Resume:   cd ${s.cwd} && claude --resume ${s.id}`);
     }
     lines.push("");
   }
@@ -136,6 +142,11 @@ export function formatSessionDetail(session: SessionEntry): string {
     lines.push(`Left off: "${s.lastMessage.slice(0, 300)}"`);
     lines.push("");
   }
+  if (s.cwd) {
+    lines.push(`Resume with:`);
+    lines.push(`  cd ${s.cwd} && claude --resume ${s.id}`);
+    lines.push("");
+  }
 
   return lines.join("\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-session-skill",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "Search, browse, and resume past Claude Code sessions with AI-generated summaries — plus an MCP server for any MCP-compatible client",
   "author": "ITeachYouAI <engineering@iteachyouai.com>",
   "license": "MIT",
@@ -30,8 +30,8 @@
   "type": "module",
   "main": "session.ts",
   "bin": {
-    "claude-session": "./bin/claude-session",
-    "claude-session-mcp": "./bin/claude-session-mcp"
+    "claude-session": "bin/claude-session",
+    "claude-session-mcp": "bin/claude-session-mcp"
   },
   "files": [
     "bin/",