claude-session-explorer 0.1.0 → 0.2.3

package/dist/cli.js

@@ -1,20 +1,56 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { Command } from 'commander';
-// src/reader.ts
-import { createReadStream } from 'fs';
-import { readdir, readFile } from 'fs/promises';
-import { homedir } from 'os';
-import { join, join as join4 } from 'path';
-import { createInterface } from 'readline';
+import { homedir } from "os";
+import { join as join7 } from "path";
+import { Command } from "commander";
+
+// src/commands/export.ts
+import { mkdir, writeFile } from "fs/promises";
+import { join as join2 } from "path";
 
+// src/output.ts
+import chalk from "chalk";
+import Table from "cli-table3";
+function writeJson(data) {
+  process.stdout.write(`${JSON.stringify(data, null, 2)}
+`);
+}
+function writeTable(headers, rows) {
+  const table = new Table({
+    head: headers.map((h) => chalk.bold(h)),
+    style: { head: [], border: [] }
+  });
+  for (const row of rows) {
+    table.push(row);
+  }
+  process.stdout.write(`${table.toString()}
+`);
+}
+function formatTimestamp(ms) {
+  return new Date(ms).toISOString().replace("T", " ").replace(/\.\d+Z$/, "");
+}
+function formatDuration(ms) {
+  const seconds = Math.floor(ms / 1e3);
+  if (seconds < 60) return `${seconds}s`;
+  const minutes = Math.floor(seconds / 60);
+  const remaining = seconds % 60;
+  if (minutes < 60) return `${minutes}m ${remaining}s`;
+  const hours = Math.floor(minutes / 60);
+  return `${hours}h ${minutes % 60}m`;
+}
+
+// src/reader.ts
+import { createReadStream } from "fs";
+import { readdir, readFile } from "fs/promises";
+import { join } from "path";
+import { createInterface } from "readline";
 async function readJsonFile(path) {
-  const content = await readFile(path, 'utf-8');
+  const content = await readFile(path, "utf-8");
   return JSON.parse(content);
 }
 async function* readJsonlFile(path) {
-  const stream = createReadStream(path, 'utf-8');
+  const stream = createReadStream(path, "utf-8");
   const rl = createInterface({ input: stream, crlfDelay: Infinity });
   for await (const line of rl) {
     const trimmed = line.trim();
@@ -24,16 +60,16 @@ async function* readJsonlFile(path) {
   }
 }
 async function listSessionFiles(claudeDir) {
-  const sessionsDir = join(claudeDir, 'sessions');
+  const sessionsDir = join(claudeDir, "sessions");
   try {
     const files2 = await readdir(sessionsDir);
-    return files2.filter((f) => f.endsWith('.json')).map((f) => join(sessionsDir, f));
+    return files2.filter((f) => f.endsWith(".json")).map((f) => join(sessionsDir, f));
   } catch {
     return [];
   }
 }
 async function listProjectDirs(claudeDir) {
-  const projectsDir = join(claudeDir, 'projects');
+  const projectsDir = join(claudeDir, "projects");
   try {
     const entries = await readdir(projectsDir, { withFileTypes: true });
     return entries.filter((e) => e.isDirectory()).map((e) => join(projectsDir, e.name));
@@ -45,7 +81,7 @@ async function findConversationFile(claudeDir, sessionId) {
   const projectDirs = await listProjectDirs(claudeDir);
   for (const dir of projectDirs) {
     const files2 = await readdir(dir);
-    const match = files2.find((f) => f.includes(sessionId) && f.endsWith('.jsonl'));
+    const match = files2.find((f) => f.includes(sessionId) && f.endsWith(".jsonl"));
     if (match) return join(dir, match);
   }
   return null;
@@ -58,228 +94,186 @@ async function readSessionMeta(path) {
   }
 }
 async function* readHistory(claudeDir) {
-  const historyPath = join(claudeDir, 'history.jsonl');
+  const historyPath = join(claudeDir, "history.jsonl");
   try {
     for await (const entry of readJsonlFile(historyPath)) {
       yield entry;
     }
-  } catch {}
+  } catch {
+  }
 }
 
-// src/output.ts
-import chalk from 'chalk';
-import Table from 'cli-table3';
-
-function writeJson(data) {
-  process.stdout.write(JSON.stringify(data, null, 2) + '\n');
-}
-function writeTable(headers, rows) {
-  const table = new Table({
-    head: headers.map((h) => chalk.bold(h)),
-    style: { head: [], border: [] },
-  });
-  for (const row of rows) {
-    table.push(row);
+// src/commands/export.ts
+function extractText(message) {
+  const content = message.content;
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    return content.filter((b) => b.type === "text").map((b) => b.text).filter(Boolean).join("\n");
   }
-  process.stdout.write(table.toString() + '\n');
+  return "";
 }
-function writeError(message) {
-  process.stderr.write(
-    chalk.red(`error: ${message}
-`),
-  );
+function extractToolCalls(message) {
+  const content = message.content;
+  if (!Array.isArray(content)) return [];
+  return content.filter((b) => b.type === "tool_use").map((b) => `\`${b.name}\``);
 }
-function formatTimestamp(ms) {
-  return new Date(ms)
-    .toISOString()
-    .replace('T', ' ')
-    .replace(/\.\d+Z$/, '');
+async function writeOutput(content, outDir, filename, stdout) {
+  if (stdout) {
+    process.stdout.write(content);
+  } else {
+    await mkdir(outDir, { recursive: true });
+    const outPath = join2(outDir, filename);
+    await writeFile(outPath, content);
+    process.stderr.write(`exported to ${outPath}
+`);
+  }
 }
-
-// src/commands/list.ts
-async function list(opts) {
-  const files2 = await listSessionFiles(opts.claudeDir);
-  const sessions = [];
-  for (const file of files2) {
-    const meta = await readSessionMeta(file);
-    if (!meta) continue;
-    if (opts.project && !meta.cwd.startsWith(opts.project)) continue;
-    if (opts.kind && meta.kind !== opts.kind) continue;
-    if (opts.entrypoint && meta.entrypoint !== opts.entrypoint) continue;
-    const startedAt = meta.startedAt;
-    if (opts.since && startedAt < new Date(opts.since).getTime()) continue;
-    if (opts.until && startedAt > new Date(opts.until).getTime()) continue;
-    if (opts.today) {
-      const todayStart = /* @__PURE__ */ new Date();
-      todayStart.setHours(0, 0, 0, 0);
-      if (startedAt < todayStart.getTime()) continue;
+function exportAsJson(entries, sessionId, opts) {
+  if (opts.stdout) {
+    writeJson(entries);
+  } else {
+    return writeOutput(JSON.stringify(entries, null, 2), opts.outDir, `${sessionId}.json`);
+  }
+}
+function buildMarkdown(entries) {
+  let title = "";
+  const sections = [];
+  for (const raw of entries) {
+    const entry = raw;
+    if (entry.type === "ai-title") {
+      title = entry.aiTitle;
+      continue;
     }
-    if (opts.thisWeek) {
-      const now = /* @__PURE__ */ new Date();
-      const weekStart = new Date(now);
-      weekStart.setDate(now.getDate() - now.getDay());
-      weekStart.setHours(0, 0, 0, 0);
-      if (startedAt < weekStart.getTime()) continue;
+    if (entry.type !== "user" && entry.type !== "assistant") continue;
+    const message = entry.message;
+    if (!message) continue;
+    const role = entry.type === "user" ? "User" : "Assistant";
+    const text = extractText(message);
+    const tools = extractToolCalls(message);
+    const timestamp = entry.timestamp ?? "";
+    if (!text && tools.length === 0) continue;
+    let section = `## ${role}`;
+    if (timestamp) section += ` <sub>${timestamp}</sub>`;
+    section += "\n\n";
+    if (text) section += text;
+    if (tools.length > 0) {
+      if (text) section += "\n\n";
+      section += `*Tools: ${tools.join(", ")}*`;
     }
-    sessions.push({
-      id: meta.sessionId,
-      date: formatTimestamp(startedAt),
-      project: meta.cwd,
-      kind: meta.kind,
-      entrypoint: meta.entrypoint,
-      startedAt,
-    });
+    sections.push(section);
   }
-  sessions.sort((a, b) => b.startedAt - a.startedAt);
-  if (opts.reverse) sessions.reverse();
-  const limited = sessions.slice(0, opts.limit);
-  if (opts.pretty) {
-    writeTable(
-      ['ID', 'Date', 'Project', 'Kind', 'Entrypoint'],
-      limited.map((s) => [s.id, s.date, s.project, s.kind, s.entrypoint]),
-    );
-  } else {
-    writeJson(limited);
+  return `# ${title || "Session"}
+
+${sections.join("\n\n---\n\n")}`;
+}
+function buildCsv(entries) {
+  const rows = ["index,type,timestamp,content_length"];
+  let index = 0;
+  for (const raw of entries) {
+    const entry = raw;
+    if (entry.type !== "user" && entry.type !== "assistant") {
+      index++;
+      continue;
+    }
+    const message = entry.message;
+    if (!message) {
+      index++;
+      continue;
+    }
+    const text = extractText(message);
+    const ts = entry.timestamp ?? "";
+    rows.push(`${index},${entry.type},${ts},${text.length}`);
+    index++;
   }
+  return rows.join("\n");
 }
-
-// src/commands/show.ts
-async function show(sessionId, opts) {
+async function exportSession(sessionId, opts) {
+  if (!sessionId) {
+    process.stderr.write("error: session ID required\n");
+    process.exit(1);
+  }
   const file = await findConversationFile(opts.claudeDir, sessionId);
   if (!file) {
-    writeError(`Session not found: ${sessionId}`);
+    process.stderr.write(`error: session not found: ${sessionId}
+`);
     process.exit(1);
   }
   const entries = [];
   for await (const entry of readJsonlFile(file)) {
     entries.push(entry);
   }
-  if (opts.raw) {
-    for (const entry of entries) {
-      process.stdout.write(JSON.stringify(entry) + '\n');
-    }
+  if (opts.format === "json") {
+    await exportAsJson(entries, sessionId, opts);
+    return;
+  }
+  if (opts.format === "md") {
+    await writeOutput(buildMarkdown(entries), opts.outDir, `${sessionId}.md`, opts.stdout);
     return;
   }
-  writeJson({ sessionId, file, entryCount: entries.length });
+  if (opts.format === "csv") {
+    await writeOutput(buildCsv(entries), opts.outDir, `${sessionId}.csv`, opts.stdout);
+    return;
+  }
+  process.stderr.write(`error: unknown format: ${opts.format}
+`);
+  process.exit(1);
 }
 
-// src/commands/search.ts
-import { readdir as readdir2 } from 'fs/promises';
-import { join as join2 } from 'path';
-
-async function search(query, opts) {
-  if (!query) {
-    writeError('Search query required');
+// src/commands/files.ts
+var TOOL_OP_MAP = {
+  Read: "read",
+  Write: "write",
+  Edit: "edit"
+};
+function extractFileOps(blocks, messageIndex, timestamp) {
+  const ops = [];
+  for (const block of blocks) {
+    if (block.type !== "tool_use") continue;
+    const operation = TOOL_OP_MAP[block.name];
+    if (!operation) continue;
+    const input = block.input;
+    const filePath = input.file_path ?? input.path ?? "";
+    ops.push({ filePath, operation, timestamp, messageIndex });
+  }
+  return ops;
+}
+async function files(sessionId, opts) {
+  const file = await findConversationFile(opts.claudeDir, sessionId);
+  if (!file) {
+    process.stderr.write(`error: session not found: ${sessionId}
+`);
     process.exit(1);
   }
-  const matcher = opts.regex
-    ? (text) => new RegExp(query).test(text)
-    : (text) => text.includes(query);
-  const results = [];
-  const projectDirs = await listProjectDirs(opts.claudeDir);
-  for (const dir of projectDirs) {
-    if (opts.project && !dir.includes(opts.project)) continue;
-    const files2 = await readdir2(dir);
-    const jsonlFiles = files2.filter((f) => f.endsWith('.jsonl'));
-    for (const file of jsonlFiles) {
-      const sessionId = file.replace('.jsonl', '');
-      let messageIndex = 0;
-      for await (const entry of readJsonlFile(join2(dir, file))) {
-        const record = entry;
-        const content = extractText(record, opts.all, opts.tools);
-        if (content && matcher(content)) {
-          results.push({
-            sessionId,
-            messageIndex,
-            timestamp: record.timestamp ?? 0,
-            matchingText: content.slice(0, 200),
-          });
+  const operations = [];
+  let messageIndex = 0;
+  for await (const entry of readJsonlFile(file)) {
+    const record = entry;
+    if (record.type === "assistant") {
+      const message = record.message;
+      const content = message?.content;
+      if (Array.isArray(content)) {
+        const ops = extractFileOps(
+          content,
+          messageIndex,
+          record.timestamp ?? 0
+        );
+        for (const op of ops) {
+          if (opts.reads && op.operation !== "read") continue;
+          if (opts.writes && op.operation !== "write") continue;
+          if (opts.edits && op.operation !== "edit") continue;
+          operations.push(op);
         }
-        messageIndex++;
       }
     }
-  }
-  writeJson(results);
-}
-function extractText(record, includeAssistant, includeTools) {
-  const type = record.type;
-  if (type === 'user' || (includeAssistant && type === 'assistant')) {
-    const content = record.content;
-    if (typeof content === 'string') return content;
-    if (Array.isArray(content)) {
-      return content
-        .filter((b) => b.type === 'text' || (includeTools && b.type === 'tool_use'))
-        .map((b) => (b.type === 'text' ? b.text : JSON.stringify(b.input)))
-        .join('\n');
-    }
-  }
-  return null;
-}
-
-// src/commands/stats.ts
-async function stats(opts) {
-  const files2 = await listSessionFiles(opts.claudeDir);
-  let sessionCount = 0;
-  const projectCounts = /* @__PURE__ */ new Map();
-  const hourCounts = new Array(24).fill(0);
-  for (const file of files2) {
-    const meta = await readSessionMeta(file);
-    if (!meta) continue;
-    if (opts.project && !meta.cwd.startsWith(opts.project)) continue;
-    sessionCount++;
-    projectCounts.set(meta.cwd, (projectCounts.get(meta.cwd) ?? 0) + 1);
-    hourCounts[new Date(meta.startedAt).getHours()]++;
-  }
-  const result = {
-    sessionCount,
-    projectBreakdown: [...projectCounts.entries()]
-      .map(([path, count]) => ({ path, sessionCount: count }))
-      .sort((a, b) => b.sessionCount - a.sessionCount),
-    hourBreakdown: hourCounts.map((count, hour) => ({ hour, sessionCount: count })),
-  };
-  if (opts.pretty) {
-    writeTable(
-      ['Metric', 'Value'],
-      [
-        ['Sessions', String(sessionCount)],
-        ['Projects', String(projectCounts.size)],
-      ],
-    );
-  } else {
-    writeJson(result);
-  }
-}
-
-// src/commands/projects.ts
-import { readdir as readdir3 } from 'fs/promises';
-import { basename } from 'path';
-
-async function projects(opts) {
-  const dirs = await listProjectDirs(opts.claudeDir);
-  const results = [];
-  for (const dir of dirs) {
-    const slug = basename(dir);
-    const files2 = await readdir3(dir);
-    const sessionFiles = files2.filter((f) => f.endsWith('.jsonl'));
-    results.push({
-      path: slug.replaceAll('-', '/'),
-      slug,
-      sessionCount: sessionFiles.length,
-      totalTokens: 0,
-      firstSession: 0,
-      lastSession: 0,
-    });
-  }
-  if (opts.sort === 'sessions') {
-    results.sort((a, b) => b.sessionCount - a.sessionCount);
+    messageIndex++;
   }
   if (opts.pretty) {
     writeTable(
-      ['Path', 'Slug', 'Sessions'],
-      results.map((p) => [p.path, p.slug, String(p.sessionCount)]),
+      ["File", "Op", "Index"],
+      operations.map((o) => [o.filePath, o.operation, String(o.messageIndex)])
     );
   } else {
-    writeJson(results);
+    writeJson(operations);
   }
 }
 
@@ -287,75 +281,135 @@ async function projects(opts) {
 async function history(opts) {
   const entries = [];
   for await (const entry of readHistory(opts.claudeDir)) {
-    if (opts.search && !entry.prompt.includes(opts.search)) continue;
+    if (opts.search && !entry.display.includes(opts.search)) continue;
     if (opts.project && !entry.project.startsWith(opts.project)) continue;
     if (opts.since && entry.timestamp < new Date(opts.since).getTime()) continue;
-    entries.push(entry);
+    entries.push({
+      display: entry.display,
+      timestamp: entry.timestamp,
+      project: entry.project,
+      sessionId: entry.sessionId
+    });
   }
   entries.sort((a, b) => b.timestamp - a.timestamp);
   const limited = entries.slice(0, opts.limit);
   if (opts.pretty) {
     writeTable(
-      ['Timestamp', 'Project', 'Prompt'],
-      limited.map((e) => [formatTimestamp(e.timestamp), e.project, e.prompt.slice(0, 80)]),
+      ["Timestamp", "Project", "Prompt"],
+      limited.map((e) => [formatTimestamp(e.timestamp), e.project, e.display.slice(0, 80)])
     );
   } else {
     writeJson(limited);
   }
 }
 
-// src/commands/files.ts
-var TOOL_OP_MAP = {
-  Read: 'read',
-  Write: 'write',
-  Edit: 'edit',
-};
-async function files(sessionId, opts) {
-  const file = await findConversationFile(opts.claudeDir, sessionId);
-  if (!file) {
-    writeError(`Session not found: ${sessionId}`);
-    process.exit(1);
-  }
-  const operations = [];
-  let messageIndex = 0;
-  for await (const entry of readJsonlFile(file)) {
-    const record = entry;
-    if (record.type === 'assistant' && Array.isArray(record.content)) {
-      for (const block of record.content) {
-        if (block.type !== 'tool_use') continue;
-        const toolName = block.name;
-        const operation = TOOL_OP_MAP[toolName];
-        if (!operation) continue;
-        if (opts.reads && operation !== 'read') continue;
-        if (opts.writes && operation !== 'write') continue;
-        if (opts.edits && operation !== 'edit') continue;
-        const input = block.input;
-        const filePath = input.file_path ?? input.path ?? '';
-        operations.push({
-          filePath,
-          operation,
-          timestamp: record.timestamp ?? 0,
-          messageIndex,
-        });
+// src/commands/list.ts
+import { readdir as readdir2 } from "fs/promises";
+import { join as join3 } from "path";
+function matchesFilters(meta, opts) {
+  if (opts.project && !meta.cwd.startsWith(opts.project)) return false;
+  if (opts.kind && meta.kind !== opts.kind) return false;
+  if (opts.entrypoint && meta.entrypoint !== opts.entrypoint) return false;
+  if (opts.since && meta.startedAt < new Date(opts.since).getTime()) return false;
+  if (opts.until && meta.startedAt > new Date(opts.until).getTime()) return false;
+  if (opts.today && meta.startedAt < todayStart()) return false;
+  if (opts.yesterday) {
+    const ys = yesterdayStart();
+    if (meta.startedAt < ys || meta.startedAt >= ys + 864e5) return false;
+  }
+  if (opts.thisWeek && meta.startedAt < weekStart()) return false;
+  return true;
+}
+function todayStart() {
+  const d = /* @__PURE__ */ new Date();
+  d.setHours(0, 0, 0, 0);
+  return d.getTime();
+}
+function yesterdayStart() {
+  return todayStart() - 864e5;
+}
+function weekStart() {
+  const now = /* @__PURE__ */ new Date();
+  const d = new Date(now);
+  d.setDate(now.getDate() - now.getDay());
+  d.setHours(0, 0, 0, 0);
+  return d.getTime();
+}
+async function findTitle(claudeDir, sessionId) {
+  let title = "";
+  let firstTs = 0;
+  let lastTs = 0;
+  const projectDirs = await listProjectDirs(claudeDir);
+  for (const dir of projectDirs) {
+    const files2 = await readdir2(dir);
+    const match = files2.find((f) => f.includes(sessionId) && f.endsWith(".jsonl"));
+    if (!match) continue;
+    for await (const entry of readJsonlFile(join3(dir, match))) {
+      const record = entry;
+      if (record.type === "ai-title") {
+        title = record.aiTitle;
+      }
+      const ts = record.timestamp;
+      if (ts) {
+        const ms = new Date(ts).getTime();
+        if (!firstTs || ms < firstTs) firstTs = ms;
+        if (ms > lastTs) lastTs = ms;
       }
     }
-    messageIndex++;
+    break;
+  }
+  return { title, durationMs: lastTs - firstTs };
+}
+async function list(opts) {
+  const files2 = await listSessionFiles(opts.claudeDir);
+  const sessions = [];
+  for (const file of files2) {
+    const meta = await readSessionMeta(file);
+    if (!meta || !matchesFilters(meta, opts)) continue;
+    const { title, durationMs } = await findTitle(opts.claudeDir, meta.sessionId);
+    sessions.push({
+      id: meta.sessionId,
+      title,
+      date: formatTimestamp(meta.startedAt),
+      project: meta.cwd,
+      duration: durationMs > 0 ? formatDuration(durationMs) : "",
+      kind: meta.kind,
+      entrypoint: meta.entrypoint,
+      startedAt: meta.startedAt,
+      durationMs
+    });
   }
+  if (opts.sort === "duration") {
+    sessions.sort((a, b) => b.durationMs - a.durationMs);
+  } else {
+    sessions.sort((a, b) => b.startedAt - a.startedAt);
+  }
+  if (opts.reverse) sessions.reverse();
+  const limited = sessions.slice(0, opts.limit);
   if (opts.pretty) {
     writeTable(
-      ['File', 'Op', 'Index'],
-      operations.map((o) => [o.filePath, o.operation, String(o.messageIndex)]),
+      ["ID", "Title", "Date", "Duration", "Project"],
+      limited.map((s) => [s.id.slice(0, 8), s.title.slice(0, 40), s.date, s.duration, s.project])
     );
   } else {
-    writeJson(operations);
+    writeJson(limited);
   }
 }
 
 // src/commands/messages.ts
+function extractText2(content, raw) {
+  if (typeof content === "string") return content;
+  if (raw) return JSON.stringify(content);
+  if (Array.isArray(content)) {
+    return content.filter((b) => b.type === "text").map((b) => b.text).filter(Boolean).join("\n");
+  }
+  return "";
+}
 async function messages(sessionId, opts) {
   const file = await findConversationFile(opts.claudeDir, sessionId);
   if (!file) {
-    writeError(`Session not found: ${sessionId}`);
+    process.stderr.write(`error: session not found: ${sessionId}
+`);
     process.exit(1);
   }
   let results = [];
@@ -363,29 +417,30 @@ async function messages(sessionId, opts) {
   for await (const entry of readJsonlFile(file)) {
     const record = entry;
     const type = record.type;
-    if (type !== 'user' && type !== 'assistant') {
+    if (type !== "user" && type !== "assistant") {
       index++;
       continue;
     }
-    if (opts.user && type !== 'user') {
+    if (opts.user && type !== "user") {
       index++;
       continue;
     }
-    if (opts.assistant && type !== 'assistant') {
+    if (opts.assistant && type !== "assistant") {
       index++;
       continue;
     }
-    const content = extractTextContent(record, opts.raw);
-    results.push({
-      index,
-      type,
-      timestamp: record.timestamp ?? 0,
-      content,
-    });
+    const message = record.message;
+    if (!message) {
+      index++;
+      continue;
+    }
+    const content = extractText2(message.content, opts.raw);
+    const timestamp = record.timestamp ?? "";
+    results.push({ index, type, timestamp, content });
     index++;
   }
   if (opts.slice) {
-    const [start, end] = opts.slice.split(':').map(Number);
+    const [start, end] = opts.slice.split(":").map(Number);
     results = results.slice(start, end);
   } else if (opts.first) {
     results = results.slice(0, opts.first);
@@ -394,202 +449,566 @@ async function messages(sessionId, opts) {
   }
   writeJson(results);
 }
-function extractTextContent(record, raw) {
-  const content = record.content;
-  if (typeof content === 'string') return content;
-  if (raw) return JSON.stringify(content);
-  if (Array.isArray(content)) {
-    return content
-      .filter((b) => b.type === 'text')
-      .map((b) => b.text)
-      .join('\n');
+
+// src/commands/projects.ts
+import { readdir as readdir3, stat } from "fs/promises";
+import { basename, join as join4 } from "path";
+async function projects(opts) {
+  const dirs = await listProjectDirs(opts.claudeDir);
+  const results = [];
+  for (const dir of dirs) {
+    const slug = basename(dir);
+    const files2 = await readdir3(dir);
+    const sessionFiles = files2.filter((f) => f.endsWith(".jsonl"));
+    let totalTokens = 0;
+    let firstSession = Number.MAX_SAFE_INTEGER;
+    let lastSession = 0;
+    for (const f of sessionFiles) {
+      const filePath = join4(dir, f);
+      const fileStat = await stat(filePath);
+      const mtimeMs = fileStat.mtimeMs;
+      const ctimeMs = fileStat.birthtimeMs || fileStat.ctimeMs;
+      if (ctimeMs < firstSession) firstSession = ctimeMs;
+      if (mtimeMs > lastSession) lastSession = mtimeMs;
+      for await (const entry of readJsonlFile(filePath)) {
+        const record = entry;
+        if (record.type !== "assistant") continue;
+        const message = record.message;
+        const usage = message?.usage;
+        if (usage) {
+          totalTokens += (usage.input_tokens ?? 0) + (usage.output_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0) + (usage.cache_creation_input_tokens ?? 0);
+        }
+      }
+    }
+    results.push({
+      path: slug.replaceAll("-", "/"),
+      slug,
+      sessionCount: sessionFiles.length,
+      totalTokens,
+      firstSession: firstSession === Number.MAX_SAFE_INTEGER ? 0 : Math.floor(firstSession),
+      lastSession: Math.floor(lastSession)
+    });
+  }
+  if (opts.sort === "recent") {
+    results.sort((a, b) => b.lastSession - a.lastSession);
+  } else if (opts.sort === "tokens") {
+    results.sort((a, b) => b.totalTokens - a.totalTokens);
+  } else {
+    results.sort((a, b) => b.sessionCount - a.sessionCount);
+  }
+  if (opts.pretty) {
+    writeTable(
+      ["Path", "Sessions", "Tokens"],
+      results.map((p) => [p.path, String(p.sessionCount), String(p.totalTokens)])
+    );
+  } else {
+    writeJson(results);
   }
-  return '';
 }
 
-// src/commands/tokens.ts
-async function tokens(sessionId, opts) {
-  if (!sessionId) {
-    writeError('Session ID required (project-level aggregation not yet implemented)');
-    process.exit(1);
+// src/commands/search.ts
+import { readdir as readdir4 } from "fs/promises";
+import { join as join5 } from "path";
+function buildMatcher(query, useRegex) {
+  if (useRegex) {
+    const re = new RegExp(query, "i");
+    return (text) => re.test(text);
+  }
+  const lower = query.toLowerCase();
+  return (text) => text.toLowerCase().includes(lower);
+}
+function extractText3(record, includeAssistant, includeTools) {
+  const type = record.type;
+  if (type !== "user" && !(includeAssistant && type === "assistant")) return null;
+  const message = record.message;
+  if (!message) return null;
+  const content = message.content;
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    const parts = [];
+    for (const block of content) {
+      if (block.type === "text" && block.text) {
+        parts.push(block.text);
+      } else if (includeTools && block.type === "tool_use" && block.input) {
+        parts.push(JSON.stringify(block.input));
+      }
+    }
+    return parts.length > 0 ? parts.join("\n") : null;
   }
-  const file = await findConversationFile(opts.claudeDir, sessionId);
-  if (!file) {
-    writeError(`Session not found: ${sessionId}`);
+  return null;
+}
+function extractMessageText(record) {
+  const message = record.message;
+  if (!message) return "";
+  const content = message.content;
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    return content.filter((b) => b.type === "text").map((b) => b.text).filter(Boolean).join("\n");
+  }
+  return "";
+}
+async function searchFile(filePath, sessionId, matcher, opts) {
+  const entries = [];
+  for await (const entry of readJsonlFile(filePath)) {
+    entries.push(entry);
+  }
+  const results = [];
+  const contextN = opts.context ? Number(opts.context) : 0;
+  for (let i = 0; i < entries.length; i++) {
+    const record = entries[i];
+    const text = extractText3(record, opts.all, opts.tools);
+    if (!text || !matcher(text)) continue;
+    const result = {
+      sessionId,
+      messageIndex: i,
+      type: record.type,
+      timestamp: record.timestamp ?? "",
+      matchingText: text.slice(0, 300)
+    };
+    if (contextN > 0) {
+      const ctx = [];
+      const start = Math.max(0, i - contextN);
+      const end = Math.min(entries.length, i + contextN + 1);
+      for (let j = start; j < end; j++) {
+        if (j === i) continue;
+        const e = entries[j];
+        const t = e.type;
+        if (t !== "user" && t !== "assistant") continue;
+        ctx.push({
+          index: j,
+          type: t,
+          text: extractMessageText(e).slice(0, 200)
+        });
+      }
+      result.context = ctx;
+    }
+    results.push(result);
+  }
+  return results;
+}
+async function search(query, opts) {
+  if (!query) {
+    process.stderr.write("error: search query required\n");
     process.exit(1);
   }
-  const turns = [];
-  let turnIndex = 0;
-  for await (const entry of readJsonlFile(file)) {
-    const record = entry;
-    const usage = record.usage;
-    if (usage) {
-      turns.push({
-        turnIndex,
-        inputTokens: usage.input_tokens ?? 0,
-        outputTokens: usage.output_tokens ?? 0,
-        cacheReadTokens: usage.cache_read_input_tokens ?? 0,
-        cacheCreationTokens: usage.cache_creation_input_tokens ?? 0,
-        model: record.model,
+  const matcher = buildMatcher(query, opts.regex);
+  const results = [];
+  const projectDirs = await listProjectDirs(opts.claudeDir);
+  for (const dir of projectDirs) {
+    if (opts.project && !dir.includes(opts.project.replaceAll("/", "-"))) continue;
+    const files2 = await readdir4(dir);
+    for (const file of files2.filter((f) => f.endsWith(".jsonl"))) {
+      const sessionId = file.replace(".jsonl", "");
+      const matches = await searchFile(join5(dir, file), sessionId, matcher, opts);
+      results.push(...matches);
+    }
+  }
+  writeJson(results);
+}
+
+// src/commands/show.ts
+var FILE_TOOLS = /* @__PURE__ */ new Set(["Read", "Write", "Edit"]);
+function extractMessageText2(msg) {
+  const content = msg.content;
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    return content.filter((b) => b.type === "text").map((b) => b.text).filter(Boolean).join("\n");
+  }
+  return "";
+}
+function showMessages(entries) {
+  const msgs = entries.filter((e) => e.type === "user" || e.type === "assistant").map((e, i) => {
+    const msg = e.message;
+    const text = msg ? extractMessageText2(msg) : "";
+    return {
+      index: i,
+      type: e.type,
+      timestamp: e.timestamp,
+      contentLength: text.length,
+      preview: text.slice(0, 150)
+    };
+  });
+  writeJson(msgs);
+}
+function showTools(entries) {
+  const toolCalls = [];
+  for (const entry of entries) {
+    if (entry.type !== "assistant") continue;
+    const msg = entry.message;
+    const content = msg?.content;
+    if (!Array.isArray(content)) continue;
+    for (const block of content) {
+      if (block.type !== "tool_use") continue;
+      const input = block.input;
+      toolCalls.push({
+        name: block.name,
+        id: block.id,
+        timestamp: entry.timestamp,
+        inputKeys: input ? Object.keys(input) : [],
+        inputPreview: input ? JSON.stringify(input).slice(0, 200) : ""
       });
     }
-    turnIndex++;
+  }
+  writeJson(toolCalls);
+}
+function showFiles(entries) {
+  const fileOps = [];
+  for (const entry of entries) {
+    if (entry.type !== "assistant") continue;
+    const msg = entry.message;
+    const content = msg?.content;
+    if (!Array.isArray(content)) continue;
+    for (const block of content) {
+      if (block.type !== "tool_use") continue;
+      if (!FILE_TOOLS.has(block.name)) continue;
+      const input = block.input;
+      fileOps.push({
+        tool: block.name,
+        filePath: input.file_path ?? input.path ?? "",
+        timestamp: entry.timestamp
+      });
+    }
+  }
+  writeJson(fileOps);
+}
+function showTokens(entries) {
+  const turns = [];
+  for (const entry of entries) {
+    const msg = entry.message;
+    const usage = msg?.usage;
+    if (!usage) continue;
+    turns.push({
+      timestamp: entry.timestamp,
+      model: msg?.model ?? "unknown",
+      inputTokens: usage.input_tokens ?? 0,
+      outputTokens: usage.output_tokens ?? 0,
+      cacheReadTokens: usage.cache_read_input_tokens ?? 0,
+      cacheCreationTokens: usage.cache_creation_input_tokens ?? 0
+    });
   }
   writeJson(turns);
 }
-
-// src/commands/export.ts
-import { mkdir, writeFile } from 'fs/promises';
-import { join as join3 } from 'path';
-
-async function exportSession(sessionId, opts) {
-  if (!sessionId) {
-    writeError('Session ID required (--all not yet implemented)');
-    process.exit(1);
+function showSummary(sessionId, file, entries) {
+  let title = "";
+  let firstTimestamp = 0;
+  let lastTimestamp = 0;
+  let userMessages = 0;
+  let assistantMessages = 0;
+  let totalInput = 0;
+  let totalOutput = 0;
+  let model = "";
+  for (const entry of entries) {
+    if (entry.type === "ai-title") title = entry.aiTitle;
+    if (entry.type === "user") userMessages++;
+    if (entry.type === "assistant") assistantMessages++;
+    const ts = entry.timestamp;
+    if (ts) {
+      const ms = new Date(ts).getTime();
+      if (!firstTimestamp || ms < firstTimestamp) firstTimestamp = ms;
+      if (ms > lastTimestamp) lastTimestamp = ms;
+    }
+    const msg = entry.message;
+    if (msg?.usage) {
+      const usage = msg.usage;
+      totalInput += (usage.input_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0) + (usage.cache_creation_input_tokens ?? 0);
+      totalOutput += usage.output_tokens ?? 0;
+      if (!model && msg.model) model = msg.model;
+    }
   }
+  writeJson({
+    sessionId,
+    title,
+    model,
+    file,
+    startedAt: firstTimestamp ? formatTimestamp(firstTimestamp) : null,
+    duration: firstTimestamp && lastTimestamp ? formatDuration(lastTimestamp - firstTimestamp) : null,
+    entryCount: entries.length,
+    userMessages,
+    assistantMessages,
+    totalInputTokens: totalInput,
+    totalOutputTokens: totalOutput
+  });
+}
+async function show(sessionId, opts) {
   const file = await findConversationFile(opts.claudeDir, sessionId);
   if (!file) {
-    writeError(`Session not found: ${sessionId}`);
+    process.stderr.write(`error: session not found: ${sessionId}
+`);
     process.exit(1);
   }
   const entries = [];
   for await (const entry of readJsonlFile(file)) {
     entries.push(entry);
   }
-  if (opts.stdout) {
-    writeJson(entries);
+  if (opts.raw) {
+    for (const entry of entries) {
+      process.stdout.write(`${JSON.stringify(entry)}
+`);
+    }
+    return;
+  }
+  if (opts.messages) return showMessages(entries);
+  if (opts.tools) return showTools(entries);
+  if (opts.files) return showFiles(entries);
+  if (opts.tokens) return showTokens(entries);
+  showSummary(sessionId, file, entries);
+}
+
+// src/commands/stats.ts
+async function scanConversationTokens(filePath) {
+  let input = 0;
+  let output = 0;
+  const tools = /* @__PURE__ */ new Map();
+  for await (const entry of readJsonlFile(filePath)) {
+    const record = entry;
+    if (record.type !== "assistant") continue;
+    const message = record.message;
+    if (!message) continue;
+    const usage = message.usage;
+    if (usage) {
+      input += (usage.input_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0) + (usage.cache_creation_input_tokens ?? 0);
+      output += usage.output_tokens ?? 0;
+    }
+    const content = message.content;
+    if (Array.isArray(content)) {
+      for (const block of content) {
+        if (block.type === "tool_use") {
+          const name = block.name;
+          tools.set(name, (tools.get(name) ?? 0) + 1);
+        }
+      }
+    }
+  }
+  return { input, output, tools };
+}
+async function stats(opts) {
+  const metaFiles = await listSessionFiles(opts.claudeDir);
+  if (opts.daily || opts.weekly) {
+    const buckets = /* @__PURE__ */ new Map();
+    for (const metaFile of metaFiles) {
+      const meta = await readSessionMeta(metaFile);
+      if (!meta) continue;
+      if (opts.project && !meta.cwd.startsWith(opts.project)) continue;
+      const date = formatTimestamp(meta.startedAt).split(" ")[0] ?? "";
+      const key = opts.weekly ? weekKey(meta.startedAt) : date;
+      const existing = buckets.get(key) ?? { sessions: 0, inputTokens: 0, outputTokens: 0 };
+      existing.sessions++;
+      const file = await findConversationFile(opts.claudeDir, meta.sessionId);
+      if (file) {
+        const scan = await scanConversationTokens(file);
+        existing.inputTokens += scan.input;
+        existing.outputTokens += scan.output;
+      }
+      buckets.set(key, existing);
+    }
+    const result = [...buckets.entries()].sort(([a], [b]) => b.localeCompare(a)).map(([date, s]) => ({
+      date,
+      sessions: s.sessions,
+      inputTokens: s.inputTokens,
+      outputTokens: s.outputTokens,
+      totalTokens: s.inputTokens + s.outputTokens
+    }));
+    writeJson(result);
     return;
   }
-  await mkdir(opts.outDir, { recursive: true });
-  const outPath = join3(opts.outDir, `${sessionId}.${opts.format}`);
-  if (opts.format === 'json') {
-    await writeFile(outPath, JSON.stringify(entries, null, 2));
-  } else if (opts.format === 'md') {
-    const md = entries
-      .filter((e) => {
-        const r = e;
-        return r.type === 'user' || r.type === 'assistant';
-      })
-      .map((e) => {
-        const r = e;
-        const role = r.type === 'user' ? 'User' : 'Assistant';
-        const content = typeof r.content === 'string' ? r.content : JSON.stringify(r.content);
-        return `## ${role}
+  let sessionCount = 0;
+  let totalInput = 0;
+  let totalOutput = 0;
+  const projectCounts = /* @__PURE__ */ new Map();
+  const hourCounts = new Array(24).fill(0);
+  const toolCounts = /* @__PURE__ */ new Map();
+  for (const metaFile of metaFiles) {
+    const meta = await readSessionMeta(metaFile);
+    if (!meta) continue;
+    if (opts.project && !meta.cwd.startsWith(opts.project)) continue;
+    sessionCount++;
+    projectCounts.set(meta.cwd, (projectCounts.get(meta.cwd) ?? 0) + 1);
+    const hour = new Date(meta.startedAt).getHours();
+    hourCounts[hour] = (hourCounts[hour] ?? 0) + 1;
+    const file = await findConversationFile(opts.claudeDir, meta.sessionId);
+    if (file) {
+      const scan = await scanConversationTokens(file);
+      totalInput += scan.input;
+      totalOutput += scan.output;
+      for (const [tool, count] of scan.tools) {
+        toolCounts.set(tool, (toolCounts.get(tool) ?? 0) + count);
+      }
+    }
+  }
+  writeJson({
+    sessionCount,
+    totalInputTokens: totalInput,
+    totalOutputTokens: totalOutput,
+    totalTokens: totalInput + totalOutput,
+    projectBreakdown: [...projectCounts.entries()].sort((a, b) => b[1] - a[1]).map(([path, count]) => ({ path, sessionCount: count })),
+    toolBreakdown: [...toolCounts.entries()].sort((a, b) => b[1] - a[1]).map(([name, callCount]) => ({ name, callCount })),
+    hourBreakdown: hourCounts.map((count, hour) => ({ hour, sessionCount: count }))
+  });
+}
+function weekKey(ms) {
+  const d = new Date(ms);
+  const day = d.getDay();
+  const monday = new Date(d);
+  monday.setDate(d.getDate() - (day + 6) % 7);
+  return formatTimestamp(monday.getTime()).split(" ")[0] ?? "";
+}
 
-${content}`;
-      })
-      .join('\n\n---\n\n');
-    await writeFile(outPath, md);
+// src/commands/tokens.ts
+import { readdir as readdir5 } from "fs/promises";
+import { join as join6 } from "path";
+function extractUsage(record) {
+  const message = record.message;
+  if (!message) return null;
+  const usage = message.usage;
+  if (!usage) return null;
+  return {
+    turnIndex: 0,
+    inputTokens: usage.input_tokens ?? 0,
+    outputTokens: usage.output_tokens ?? 0,
+    cacheReadTokens: usage.cache_read_input_tokens ?? 0,
+    cacheCreationTokens: usage.cache_creation_input_tokens ?? 0,
+    model: message.model ?? "unknown"
+  };
+}
+async function sessionTokens(filePath) {
+  const turns = [];
+  let turnIndex = 0;
+  for await (const entry of readJsonlFile(filePath)) {
+    const record = entry;
+    const usage = extractUsage(record);
+    if (usage) {
+      usage.turnIndex = turnIndex;
+      turns.push(usage);
+    }
+    turnIndex++;
+  }
+  return turns;
+}
+function newBucket() {
+  return { input: 0, output: 0, cacheRead: 0, cacheCreation: 0 };
+}
+function addTurnToBucket(bucket, t) {
+  bucket.input += t.inputTokens;
+  bucket.output += t.outputTokens;
+  bucket.cacheRead += t.cacheReadTokens;
+  bucket.cacheCreation += t.cacheCreationTokens;
+}
+function bucketTotal(b) {
+  return b.input + b.output + b.cacheRead + b.cacheCreation;
+}
+async function tokensByModel(opts) {
+  const modelTotals = /* @__PURE__ */ new Map();
+  const projectDirs = await listProjectDirs(opts.claudeDir);
+  for (const dir of projectDirs) {
+    if (opts.project && !dir.includes(opts.project.replaceAll("/", "-"))) continue;
+    const files2 = await readdir5(dir);
+    for (const f of files2.filter((x) => x.endsWith(".jsonl"))) {
+      const turns = await sessionTokens(join6(dir, f));
+      for (const t of turns) {
+        const existing = modelTotals.get(t.model) ?? newBucket();
+        addTurnToBucket(existing, t);
+        modelTotals.set(t.model, existing);
+      }
+    }
+  }
+  writeJson(
+    [...modelTotals.entries()].map(([model, b]) => ({
+      model,
+      inputTokens: b.input,
+      outputTokens: b.output,
+      cacheReadTokens: b.cacheRead,
+      cacheCreationTokens: b.cacheCreation,
+      totalTokens: bucketTotal(b)
+    }))
+  );
+}
+async function tokensDaily(opts) {
+  const dailyTotals = /* @__PURE__ */ new Map();
+  const metaFiles = await listSessionFiles(opts.claudeDir);
+  for (const metaFile of metaFiles) {
+    const meta = await readSessionMeta(metaFile);
+    if (!meta) continue;
+    if (opts.project && !meta.cwd.startsWith(opts.project)) continue;
+    const file = await findConversationFile(opts.claudeDir, meta.sessionId);
+    if (!file) continue;
+    const dateKey = formatTimestamp(meta.startedAt).split(" ")[0] ?? "";
+    const turns = await sessionTokens(file);
+    const existing = dailyTotals.get(dateKey) ?? newBucket();
+    for (const t of turns) addTurnToBucket(existing, t);
+    dailyTotals.set(dateKey, existing);
+  }
+  writeJson(
+    [...dailyTotals.entries()].sort(([a], [b]) => b.localeCompare(a)).map(([date, b]) => ({
+      date,
+      inputTokens: b.input,
+      outputTokens: b.output,
+      cacheReadTokens: b.cacheRead,
+      cacheCreationTokens: b.cacheCreation,
+      totalTokens: bucketTotal(b)
+    }))
+  );
+}
+async function tokensByProject(project, opts) {
+  const metaFiles = await listSessionFiles(opts.claudeDir);
+  const summaries = [];
+  for (const metaFile of metaFiles) {
+    const meta = await readSessionMeta(metaFile);
+    if (!meta?.cwd.startsWith(project)) continue;
+    const file = await findConversationFile(opts.claudeDir, meta.sessionId);
+    if (!file) continue;
+    const turns = await sessionTokens(file);
+    const b = newBucket();
+    for (const t of turns) addTurnToBucket(b, t);
+    summaries.push({
+      sessionId: meta.sessionId,
+      inputTokens: b.input,
+      outputTokens: b.output,
+      cacheReadTokens: b.cacheRead,
+      cacheCreationTokens: b.cacheCreation,
+      totalTokens: bucketTotal(b)
+    });
   }
-  process.stderr.write(`Exported to ${outPath}
+  writeJson(summaries);
+}
+async function tokens(sessionId, opts) {
+  if (sessionId) {
+    const file = await findConversationFile(opts.claudeDir, sessionId);
+    if (!file) {
+      process.stderr.write(`error: session not found: ${sessionId}
 `);
+      process.exit(1);
+    }
+    writeJson(await sessionTokens(file));
+    return;
+  }
+  if (opts.byModel) return tokensByModel(opts);
+  if (opts.daily) return tokensDaily(opts);
+  if (opts.project) return tokensByProject(opts.project, opts);
+  process.stderr.write("error: provide a session ID, --project, --daily, or --by-model\n");
+  process.exit(1);
 }
 
 // src/cli.ts
 var program = new Command();
-program
-  .name('cse')
-  .description('Deterministic CLI for Claude Code session history')
-  .version('0.1.0')
-  .option('--claude-dir <path>', 'override ~/.claude location', join4(homedir(), '.claude'))
-  .option('--out-dir <path>', 'override output directory', '.cse')
-  .option('--stdout', 'write to stdout instead of file')
-  .option('--json', 'JSON output (default)', true)
-  .option('--pretty', 'human-readable table output')
-  .option('--no-color', 'disable colored output')
-  .option('--verbose', 'debug info to stderr');
+program.name("cse").description("Deterministic CLI for Claude Code session history").version("0.1.0").option("--claude-dir <path>", "override ~/.claude location", join7(homedir(), ".claude")).option("--out-dir <path>", "override output directory", ".cse").option("--stdout", "write to stdout instead of file").option("--json", "JSON output (default)", true).option("--pretty", "human-readable table output").option("--no-color", "disable colored output").option("--verbose", "debug info to stderr");
 function globals() {
   return program.opts();
 }
-program
-  .command('list')
-  .description('List sessions')
-  .option('--project <path>', 'filter by project directory')
-  .option('--since <date>', 'filter by start date')
-  .option('--until <date>', 'filter by end date')
-  .option('--today', "shorthand for today's sessions")
-  .option('--this-week', 'shorthand for current week')
-  .option('--kind <kind>', 'filter by session kind')
-  .option('--entrypoint <ep>', 'filter by entrypoint (cli/ide/web)')
-  .option('--limit <n>', 'limit results', '50')
-  .option('--sort <field>', 'sort: date, duration, tokens, messages', 'date')
-  .option('--reverse', 'reverse sort order')
-  .action((opts) => list({ ...globals(), ...opts, limit: Number(opts.limit) }));
-program
-  .command('show <session-id>')
-  .description('Show session detail')
-  .option('--messages', 'all messages with type, timestamp, content length')
-  .option('--tools', 'all tool_use blocks')
-  .option('--files', 'all file paths from tool_use inputs')
-  .option('--tokens', 'per-turn token usage')
-  .option('--raw', 'raw JSONL lines')
-  .action((id, opts) => show(id, { ...globals(), ...opts }));
-program
-  .command('search <query>')
-  .description('Full-text search across sessions')
-  .option('--all', 'search user + assistant content')
-  .option('--tools', 'search tool_use inputs/outputs')
-  .option('--project <path>', 'scope to project')
-  .option('--since <date>', 'filter by date')
-  .option('--context <n>', 'include N messages around match')
-  .option('--regex', 'treat query as regex')
-  .action((query, opts) => search(query, { ...globals(), ...opts }));
-program
-  .command('stats')
-  .description('Aggregate statistics')
-  .option('--project <path>', 'per-project stats')
-  .option('--daily', 'daily breakdown')
-  .option('--weekly', 'weekly breakdown')
-  .action((opts) => stats({ ...globals(), ...opts }));
-program
-  .command('projects')
-  .description('List all projects')
-  .option('--sort <field>', 'sort: sessions, tokens, recent', 'sessions')
-  .action((opts) => projects({ ...globals(), ...opts }));
-program
-  .command('history')
-  .description('Prompt history')
-  .option('--search <text>', 'exact substring match on prompt text')
-  .option('--project <path>', 'filter by project')
-  .option('--since <date>', 'filter by date')
-  .option('--limit <n>', 'number of entries', '50')
-  .action((opts) => history({ ...globals(), ...opts, limit: Number(opts.limit) }));
-program
-  .command('files <session-id>')
-  .description('Extract file operations')
-  .option('--reads', 'only Read tool calls')
-  .option('--writes', 'only Write tool calls')
-  .option('--edits', 'only Edit tool calls')
-  .action((id, opts) => files(id, { ...globals(), ...opts }));
-program
-  .command('messages <session-id>')
-  .description('Extract messages')
-  .option('--user', 'only user messages')
-  .option('--assistant', 'only assistant messages')
-  .option('--first <n>', 'first N messages')
-  .option('--last <n>', 'last N messages')
-  .option('--slice <range>', 'message range by index (e.g. 5:15)')
-  .option('--raw', 'include tool blocks')
-  .action((id, opts) =>
-    messages(id, {
-      ...globals(),
-      ...opts,
-      first: opts.first ? Number(opts.first) : void 0,
-      last: opts.last ? Number(opts.last) : void 0,
-    }),
-  );
-program
-  .command('tokens [session-id]')
-  .description('Token usage')
-  .option('--project <path>', 'aggregate per-session for a project')
-  .option('--daily', 'daily token totals')
-  .option('--by-model', 'grouped by model')
-  .action((id, opts) => tokens(id, { ...globals(), ...opts }));
-program
-  .command('export [session-id]')
-  .description('Export data')
-  .option('--format <fmt>', 'output format: json, md, csv', 'json')
-  .option('--all', 'export all sessions')
-  .option('--project <path>', 'export project sessions')
-  .action((id, opts) => exportSession(id, { ...globals(), ...opts }));
+program.command("list").description("List sessions").option("--project <path>", "filter by project directory").option("--since <date>", "filter by start date").option("--until <date>", "filter by end date").option("--today", "shorthand for today's sessions").option("--yesterday", "shorthand for yesterday's sessions").option("--this-week", "shorthand for current week").option("--kind <kind>", "filter by session kind").option("--entrypoint <ep>", "filter by entrypoint (cli/ide/web)").option("--limit <n>", "limit results", "50").option("--sort <field>", "sort: date, duration, tokens, messages", "date").option("--reverse", "reverse sort order").action((opts) => list({ ...globals(), ...opts, limit: Number(opts.limit) }));
+program.command("show <session-id>").description("Show session detail").option("--messages", "all messages with type, timestamp, content length").option("--tools", "all tool_use blocks").option("--files", "all file paths from tool_use inputs").option("--tokens", "per-turn token usage").option("--raw", "raw JSONL lines").action((id, opts) => show(id, { ...globals(), ...opts }));
+program.command("search <query>").description("Full-text search across sessions").option("--all", "search user + assistant content").option("--tools", "search tool_use inputs/outputs").option("--project <path>", "scope to project").option("--since <date>", "filter by date").option("--context <n>", "include N messages around match").option("--regex", "treat query as regex").action((query, opts) => search(query, { ...globals(), ...opts }));
+program.command("stats").description("Aggregate statistics").option("--project <path>", "per-project stats").option("--daily", "daily breakdown").option("--weekly", "weekly breakdown").action((opts) => stats({ ...globals(), ...opts }));
+program.command("projects").description("List all projects").option("--sort <field>", "sort: sessions, tokens, recent", "sessions").action((opts) => projects({ ...globals(), ...opts }));
+program.command("history").description("Prompt history").option("--search <text>", "exact substring match on prompt text").option("--project <path>", "filter by project").option("--since <date>", "filter by date").option("--limit <n>", "number of entries", "50").action((opts) => history({ ...globals(), ...opts, limit: Number(opts.limit) }));
+program.command("files <session-id>").description("Extract file operations").option("--reads", "only Read tool calls").option("--writes", "only Write tool calls").option("--edits", "only Edit tool calls").action((id, opts) => files(id, { ...globals(), ...opts }));
+program.command("messages <session-id>").description("Extract messages").option("--user", "only user messages").option("--assistant", "only assistant messages").option("--first <n>", "first N messages").option("--last <n>", "last N messages").option("--slice <range>", "message range by index (e.g. 5:15)").option("--raw", "include tool blocks").action(
+  (id, opts) => messages(id, {
+    ...globals(),
+    ...opts,
+    first: opts.first ? Number(opts.first) : void 0,
+    last: opts.last ? Number(opts.last) : void 0
+  })
+);
+program.command("tokens [session-id]").description("Token usage").option("--project <path>", "aggregate per-session for a project").option("--daily", "daily token totals").option("--by-model", "grouped by model").action((id, opts) => tokens(id, { ...globals(), ...opts }));
+program.command("export [session-id]").description("Export data").option("--format <fmt>", "output format: json, md, csv", "json").option("--all", "export all sessions").option("--project <path>", "export project sessions").action((id, opts) => exportSession(id, { ...globals(), ...opts }));
 program.parse();