theirongolddev/session-viewer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add Express server: session discovery, JSONL parser, HTML exporter, API routes

Browse Source 
Server-side implementation for reading, parsing, and exporting Claude
Code session logs:

session-discovery.ts:
- Walks ~/.claude/projects/ directories, reads sessions-index.json from
  each project folder, supports both the current {version, entries}
  format and the legacy raw array format
- Aggregates sessions across all projects, sorted by most recently
  modified first
- Gracefully handles missing directories, corrupt index files, and
  missing entries

session-parser.ts:
- Parses Claude Code JSONL session files line-by-line into normalized
  ParsedMessage objects
- Handles the full real-world format: type="user" (string or
  ContentBlock array content), type="assistant" (text, thinking,
  tool_use blocks), type="progress" (hook events with structured data
  fields), type="summary" (summary text field), type="file-history-
  snapshot", and silently skips type="system" (turn_duration metadata)
  and type="queue-operation" (internal)
- Detects <system-reminder> tags in user messages and reclassifies them
  as system_message category
- Resilient to malformed JSONL lines (skips with continue, no crash)

html-exporter.ts:
- Generates self-contained HTML exports with no external dependencies —
  all CSS (layout, category-specific colors, syntax highlighting) is
  inlined in a <style> block
- Dark theme (GitHub dark palette) with category-specific left border
  colors and backgrounds matching the Claude Code aesthetic
- Renders markdown content via marked + highlight.js with syntax
  highlighting, inserts "content redacted" dividers where redacted
  messages were removed
- Outputs a complete <!DOCTYPE html> document with session metadata
  header (project name, date, message count)

routes/sessions.ts:
- GET /api/sessions — returns all discovered sessions with 30-second
  in-memory cache to avoid re-scanning the filesystem on every request
- GET /api/sessions/:id — looks up session by ID from cache, parses
  the JSONL file, returns parsed messages

routes/export.ts:
- POST /api/export — accepts ExportRequest body, validates required
  fields, generates HTML via the exporter, returns as a downloadable
  attachment with sanitized filename

index.ts:
- Express app factory (createApp) with 50MB JSON body limit, health
  check endpoint, session and export routers, and static file serving
  for the built client
- Dual-bind to localhost and Tailscale IP (100.84.4.113) for local +
  tailnet access, with optional browser-open on startup via
  SESSION_VIEWER_OPEN_BROWSER env var
- Auto-start guard: only calls startServer() when run directly, not
  when imported by tests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Taylor Eernisse
2026-01-29 22:56:10 -05:00
parent c4e15bf082
commit 090d69a97a
6 changed files with 672 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
src/server/routes/sessions.ts Normal file
View File

@@ -0,0 +1,50 @@
import { Router } from "express";
import { discoverSessions } from "../services/session-discovery.js";
import { parseSession } from "../services/session-parser.js";
import type { SessionEntry } from "../../shared/types.js";
export const sessionsRouter = Router();
// Simple cache to avoid re-discovering sessions on every detail request
let cachedSessions: SessionEntry[] = [];
let cacheTimestamp = 0;
const CACHE_TTL_MS = 30_000;
async function getCachedSessions(): Promise<SessionEntry[]> {
const now = Date.now();
if (now - cacheTimestamp > CACHE_TTL_MS) {
cachedSessions = await discoverSessions();
cacheTimestamp = now;
}
return cachedSessions;
}
sessionsRouter.get("/", async (_req, res) => {
try {
const sessions = await getCachedSessions();
res.json({ sessions });
} catch (err) {
console.error("Failed to discover sessions:", err);
res.status(500).json({ error: "Failed to discover sessions" });
}
});
sessionsRouter.get("/:id", async (req, res) => {
try {
const sessions = await getCachedSessions();
const entry = sessions.find((s) => s.id === req.params.id);
if (!entry) {
res.status(404).json({ error: "Session not found" });
return;
}
const messages = await parseSession(entry.path);
res.json({
id: entry.id,
project: entry.project,
messages,
});
} catch (err) {
console.error("Failed to load session:", err);
res.status(500).json({ error: "Failed to load session" });
}
});