claude-session-skill 1.1.7 → 1.1.8

package/lib/create-server.ts

@@ -0,0 +1,311 @@
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+import { buildIndex, nameSession, clearSessionName, resolveSession } from "./indexer";
+import { searchSessions } from "./search";
+import {
+  formatSessionList,
+  formatSearchResults,
+  formatSessionDetail,
+  formatStats,
+  makeAutoSessionName,
+} from "./format";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+
+export function createServer(): Server {
+  const server = new Server(
+    { name: "claude-session", version: pkg.version },
+    { capabilities: { tools: {} } }
+  );
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+      {
+        name: "list_sessions",
+        description: "List recent Claude Code sessions with AI-generated summaries, sorted by last activity.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            limit: {
+              type: "number",
+              description: "Max sessions to return. Defaults to all sessions.",
+            },
+          },
+        },
+      },
+      {
+        name: "search_sessions",
+        description: "Search Claude Code sessions by keyword, project path, topic, or quoted phrase.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description: "Search query. Supports quoted phrases for exact matches, e.g. \"auth bug\".",
+            },
+          },
+          required: ["query"],
+        },
+      },
+      {
+        name: "show_session",
+        description: "Show detailed information about a specific session: project, branch, timestamps, message count, and AI summary.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "string",
+              description: "Full or partial session ID (first 8+ characters are sufficient).",
+            },
+          },
+          required: ["id"],
+        },
+      },
+      {
+        name: "name_session",
+        description: "Give a session a memorable name for easy recall. Defaults to the most recent session if no ID is provided.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "string",
+              description: "Session ID or prefix. If omitted, names the most recent session.",
+            },
+            name: {
+              type: "string",
+              description: "Name to assign (max 50 characters).",
+            },
+          },
+          required: ["name"],
+        },
+      },
+      {
+        name: "autoname_session",
+        description: "Generate a session title from its summary and prefix it with the session start time as dd/mm/yy HH:MM.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "string",
+              description: "Session ID or prefix. If omitted, names the most recent session.",
+            },
+          },
+        },
+      },
+      {
+        name: "unname_session",
+        description: "Remove the name from a session. Defaults to the most recent session if no ID is provided.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "string",
+              description: "Session ID or prefix. If omitted, clears the name of the most recent session.",
+            },
+          },
+          required: ["id"],
+        },
+      },
+      {
+        name: "session_stats",
+        description: "Show session statistics broken down by project: session count, message count, and last activity.",
+        inputSchema: {
+          type: "object",
+          properties: {},
+        },
+      },
+    ],
+  }));
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+
+    try {
+      switch (name) {
+        case "list_sessions": {
+          const sessions = await buildIndex();
+          const limit = typeof args?.limit === "number" ? args.limit : undefined;
+          const list = limit ? sessions.slice(0, limit) : sessions;
+          return {
+            content: [{ type: "text", text: formatSessionList(list, true) }],
+          };
+        }
+
+        case "search_sessions": {
+          const query = String(args?.query ?? "").trim();
+          if (!query) {
+            return {
+              content: [{ type: "text", text: "Error: query is required." }],
+              isError: true,
+            };
+          }
+          const sessions = await buildIndex();
+          const results = searchSessions(sessions, query);
+          return {
+            content: [{ type: "text", text: formatSearchResults(results, query) }],
+          };
+        }
+
+        case "show_session": {
+          const id = String(args?.id ?? "").trim();
+          if (!id) {
+            return {
+              content: [{ type: "text", text: "Error: id is required." }],
+              isError: true,
+            };
+          }
+          const sessions = await buildIndex();
+          const resolved = resolveSession(sessions, id);
+          if (!resolved.ok) {
+            return {
+              content: [{ type: "text", text: `Error: ${resolved.error}` }],
+              isError: true,
+            };
+          }
+          return {
+            content: [{ type: "text", text: formatSessionDetail(resolved.match) }],
+          };
+        }
+
+        case "name_session": {
+          const sessionName = String(args?.name ?? "").trim();
+          if (!sessionName) {
+            return {
+              content: [{ type: "text", text: "Error: name is required." }],
+              isError: true,
+            };
+          }
+
+          let sessionId: string;
+          if (args?.id) {
+            sessionId = String(args.id).trim();
+          } else {
+            // Default to most recent session
+            const sessions = await buildIndex();
+            if (sessions.length === 0) {
+              return {
+                content: [{ type: "text", text: "Error: No sessions found." }],
+                isError: true,
+              };
+            }
+            sessionId = sessions[0].id;
+          }
+
+          const result = await nameSession(sessionId, sessionName);
+          if (!result.ok) {
+            return {
+              content: [{ type: "text", text: `Error: ${result.error}` }],
+              isError: true,
+            };
+          }
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Named session ${(result.fullId ?? "").slice(0, 8)}... → "${sessionName}"`,
+              },
+            ],
+          };
+        }
+
+        case "autoname_session": {
+          const sessions = await buildIndex();
+          if (sessions.length === 0) {
+            return {
+              content: [{ type: "text", text: "Error: No sessions found." }],
+              isError: true,
+            };
+          }
+
+          const sessionId = args?.id ? String(args.id).trim() : sessions[0].id;
+          const resolved = resolveSession(sessions, sessionId);
+          if (!resolved.ok) {
+            return {
+              content: [{ type: "text", text: `Error: ${resolved.error}` }],
+              isError: true,
+            };
+          }
+
+          const generatedName = makeAutoSessionName(resolved.match);
+          const result = await nameSession(resolved.match.id, generatedName);
+          if (!result.ok) {
+            return {
+              content: [{ type: "text", text: `Error: ${result.error}` }],
+              isError: true,
+            };
+          }
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Named session ${(result.fullId ?? "").slice(0, 8)}... → "${generatedName}"`,
+              },
+            ],
+          };
+        }
+
+        case "unname_session": {
+          let sessionId: string;
+          if (args?.id) {
+            sessionId = String(args.id).trim();
+          } else {
+            const sessions = await buildIndex();
+            if (sessions.length === 0) {
+              return {
+                content: [{ type: "text", text: "Error: No sessions found." }],
+                isError: true,
+              };
+            }
+            sessionId = sessions[0].id;
+          }
+
+          const result = await clearSessionName(sessionId);
+          if (!result.ok) {
+            return {
+              content: [{ type: "text", text: `Error: ${result.error}` }],
+              isError: true,
+            };
+          }
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Cleared name from session ${(result.fullId ?? "").slice(0, 8)}...`,
+              },
+            ],
+          };
+        }
+
+        case "session_stats": {
+          const sessions = await buildIndex();
+          return {
+            content: [{ type: "text", text: formatStats(sessions) }],
+          };
+        }
+
+        default:
+          return {
+            content: [{ type: "text", text: `Error: Unknown tool "${name}"` }],
+            isError: true,
+          };
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+      };
+    }
+  });
+
+  return server;
+}

package/lib/format.ts

@@ -10,6 +10,10 @@ function truncate(s: string, max: number): string {
   return chars.slice(0, max - 3).join("") + "...";
 }
 
+function normalizeWhitespace(value: string): string {
+  return value.replace(/\s+/g, " ").trim();
+}
+
 function formatDate(ts: number): string {
   if (!ts) return "unknown";
   const d = new Date(ts);
@@ -23,8 +27,19 @@ function formatDate(ts: number): string {
   return `${month} ${day}, ${h}:${mins} ${ampm}`;
 }
 
+function formatNameTimestamp(ts: number): string {
+  if (!ts) return "unknown";
+  const d = new Date(ts);
+  const day = d.getDate().toString().padStart(2, "0");
+  const month = (d.getMonth() + 1).toString().padStart(2, "0");
+  const year = (d.getFullYear() % 100).toString().padStart(2, "0");
+  const hours = d.getHours().toString().padStart(2, "0");
+  const minutes = d.getMinutes().toString().padStart(2, "0");
+  return `${day}/${month}/${year} ${hours}:${minutes}`;
+}
+
 // Get single-line display for list view — first bullet or last message
-function displayLine(s: SessionEntry): string {
+export function displayLine(s: SessionEntry): string {
   if (s.topic && !isGarbageSummary(s.topic)) {
     // If topic has bullets, return just the first one
     const lines = s.topic.split("\n").filter((l: string) => l.trim().length > 0);
@@ -37,6 +52,21 @@ function displayLine(s: SessionEntry): string {
   return s.firstMessage || "(no messages)";
 }
 
+export function makeAutoSessionName(s: SessionEntry, maxLength = 50): string {
+  const prefix = formatNameTimestamp(s.firstTimestamp);
+  const summary = displayLine(s);
+  const cleanSummary = normalizeWhitespace(
+    summary.startsWith("- ") ? summary.slice(2) : summary
+  ).replace(/^["']+|["']+$/g, "");
+
+  if (!cleanSummary) return prefix;
+
+  const available = maxLength - prefix.length - 1;
+  if (available <= 0) return prefix.slice(0, maxLength);
+
+  return `${prefix} ${truncate(cleanSummary, available)}`;
+}
+
 // Combine name + summary for list/search views
 function makeLabel(s: SessionEntry, summary: string): string {
   if (!s.name) return summary;

package/mcp-server.ts

@@ -1,259 +1,11 @@
 #!/usr/bin/env bun
 
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} from "@modelcontextprotocol/sdk/types.js";
-
-import { buildIndex, nameSession, clearSessionName, resolveSession } from "./lib/indexer";
-import { searchSessions } from "./lib/search";
-import {
-  formatSessionList,
-  formatSearchResults,
-  formatSessionDetail,
-  formatStats,
-} from "./lib/format";
+import { createServer } from "./lib/create-server";
 
 // NEVER use console.log() — corrupts JSON-RPC stdio stream.
 // Only process.stderr (debug) is safe.
 
-const server = new Server(
-  { name: "claude-session", version: "1.1.0" },
-  { capabilities: { tools: {} } }
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: [
-    {
-      name: "list_sessions",
-      description: "List recent Claude Code sessions with AI-generated summaries, sorted by last activity.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          limit: {
-            type: "number",
-            description: "Max sessions to return. Defaults to all sessions.",
-          },
-        },
-      },
-    },
-    {
-      name: "search_sessions",
-      description: "Search Claude Code sessions by keyword, project path, topic, or quoted phrase.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          query: {
-            type: "string",
-            description: "Search query. Supports quoted phrases for exact matches, e.g. \"auth bug\".",
-          },
-        },
-        required: ["query"],
-      },
-    },
-    {
-      name: "show_session",
-      description: "Show detailed information about a specific session: project, branch, timestamps, message count, and AI summary.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          id: {
-            type: "string",
-            description: "Full or partial session ID (first 8+ characters are sufficient).",
-          },
-        },
-        required: ["id"],
-      },
-    },
-    {
-      name: "name_session",
-      description: "Give a session a memorable name for easy recall. Defaults to the most recent session if no ID is provided.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          id: {
-            type: "string",
-            description: "Session ID or prefix. If omitted, names the most recent session.",
-          },
-          name: {
-            type: "string",
-            description: "Name to assign (max 50 characters).",
-          },
-        },
-        required: ["name"],
-      },
-    },
-    {
-      name: "unname_session",
-      description: "Remove the name from a session. Defaults to the most recent session if no ID is provided.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          id: {
-            type: "string",
-            description: "Session ID or prefix. If omitted, clears the name of the most recent session.",
-          },
-        },
-        required: ["id"],
-      },
-    },
-    {
-      name: "session_stats",
-      description: "Show session statistics broken down by project: session count, message count, and last activity.",
-      inputSchema: {
-        type: "object",
-        properties: {},
-      },
-    },
-  ],
-}));
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-
-  try {
-    switch (name) {
-      case "list_sessions": {
-        const sessions = await buildIndex();
-        const limit = typeof args?.limit === "number" ? args.limit : undefined;
-        const list = limit ? sessions.slice(0, limit) : sessions;
-        return {
-          content: [{ type: "text", text: formatSessionList(list, true) }],
-        };
-      }
-
-      case "search_sessions": {
-        const query = String(args?.query ?? "").trim();
-        if (!query) {
-          return {
-            content: [{ type: "text", text: "Error: query is required." }],
-            isError: true,
-          };
-        }
-        const sessions = await buildIndex();
-        const results = searchSessions(sessions, query);
-        return {
-          content: [{ type: "text", text: formatSearchResults(results, query) }],
-        };
-      }
-
-      case "show_session": {
-        const id = String(args?.id ?? "").trim();
-        if (!id) {
-          return {
-            content: [{ type: "text", text: "Error: id is required." }],
-            isError: true,
-          };
-        }
-        const sessions = await buildIndex();
-        const resolved = resolveSession(sessions, id);
-        if (!resolved.ok) {
-          return {
-            content: [{ type: "text", text: `Error: ${resolved.error}` }],
-            isError: true,
-          };
-        }
-        return {
-          content: [{ type: "text", text: formatSessionDetail(resolved.match) }],
-        };
-      }
-
-      case "name_session": {
-        const sessionName = String(args?.name ?? "").trim();
-        if (!sessionName) {
-          return {
-            content: [{ type: "text", text: "Error: name is required." }],
-            isError: true,
-          };
-        }
-
-        let sessionId: string;
-        if (args?.id) {
-          sessionId = String(args.id).trim();
-        } else {
-          // Default to most recent session
-          const sessions = await buildIndex();
-          if (sessions.length === 0) {
-            return {
-              content: [{ type: "text", text: "Error: No sessions found." }],
-              isError: true,
-            };
-          }
-          sessionId = sessions[0].id;
-        }
-
-        const result = await nameSession(sessionId, sessionName);
-        if (!result.ok) {
-          return {
-            content: [{ type: "text", text: `Error: ${result.error}` }],
-            isError: true,
-          };
-        }
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Named session ${(result.fullId ?? "").slice(0, 8)}... → "${sessionName}"`,
-            },
-          ],
-        };
-      }
-
-      case "unname_session": {
-        let sessionId: string;
-        if (args?.id) {
-          sessionId = String(args.id).trim();
-        } else {
-          const sessions = await buildIndex();
-          if (sessions.length === 0) {
-            return {
-              content: [{ type: "text", text: "Error: No sessions found." }],
-              isError: true,
-            };
-          }
-          sessionId = sessions[0].id;
-        }
-
-        const result = await clearSessionName(sessionId);
-        if (!result.ok) {
-          return {
-            content: [{ type: "text", text: `Error: ${result.error}` }],
-            isError: true,
-          };
-        }
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Cleared name from session ${(result.fullId ?? "").slice(0, 8)}...`,
-            },
-          ],
-        };
-      }
-
-      case "session_stats": {
-        const sessions = await buildIndex();
-        return {
-          content: [{ type: "text", text: formatStats(sessions) }],
-        };
-      }
-
-      default:
-        return {
-          content: [{ type: "text", text: `Error: Unknown tool "${name}"` }],
-          isError: true,
-        };
-    }
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return {
-      content: [{ type: "text", text: `Error: ${message}` }],
-      isError: true,
-    };
-  }
-});
-
+const server = createServer();
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-session-skill",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "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",

package/session.ts

@@ -7,6 +7,7 @@ import {
   formatSearchResults,
   formatSessionDetail,
   formatStats,
+  makeAutoSessionName,
 } from "./lib/format";
 
 const args = process.argv.slice(2);
@@ -88,6 +89,31 @@ async function main() {
       break;
     }
 
+    case "autoname": {
+      const rest = args.slice(1);
+      const sessions = await buildIndex();
+      if (sessions.length === 0) {
+        console.error("No sessions found.");
+        process.exit(1);
+      }
+
+      const sessionId = rest[0] ?? sessions[0].id;
+      const resolved = resolveSession(sessions, sessionId);
+      if (!resolved.ok) {
+        console.error(resolved.error);
+        process.exit(1);
+      }
+
+      const generatedName = makeAutoSessionName(resolved.match);
+      const result = await nameSession(resolved.match.id, generatedName);
+      if (!result.ok) {
+        console.error(result.error);
+        process.exit(1);
+      }
+      console.log(`Named session ${(result.fullId ?? "").slice(0, 8)}... → "${generatedName}"`);
+      break;
+    }
+
     case "unname":
     case "clear-name": {
       const rest = args.slice(1);
@@ -155,6 +181,7 @@ async function main() {
   session show <id>        Show session details (partial ID ok)
   session name <name>      Name the most recent session
   session name <id> <name> Name a specific session (partial ID ok)
+  session autoname [<id>]  Name a session from its summary + start time
   session unname [<id>]    Clear a session's name
   session search <query>   Search sessions by keyword
   session rebuild          Force rebuild the index