claude-sessions CLAUDE.md

Claude Sessions — Obsidian Plugin

Desktop-only Claude Code JSONL session viewer for Obsidian. Browse, search, and export sessions with rich tool rendering, live watch, and summary dashboards.

Version: 0.3.22 | Branch: main

Development

npm run dev          # watch mode
npm run build        # production (typecheck + bundle + copy to vault)
npm test             # vitest
npm run test:watch   # watch mode tests
npx eslint .         # lint

File Structure

src/
  main.ts                    # Plugin entry, commands, protocol handler
  settings.ts                # Declarative settings tab (1.13.0+ getSettingDefinitions)
  types.ts                   # All shared interfaces and types
  constants.ts               # JSONL protocol strings, regexes, display strings
  api.ts                     # Public API for inter-plugin communication
  parsers/
    claude-parser.ts         # Core JSONL parser (record merging, dedup, stats)
    claude-content.ts        # Content block parsing, tool result extraction
    claude-subagent.ts       # Sub-agent JSONL resolution
    base-parser.ts           # Abstract base (splitLines, tryParseJson)
    detect.ts                # Format detection
  views/
    timeline-view.ts         # ItemView — timeline, controls, filters, live watch
    timeline-renderer.ts     # Turn/block rendering, ANSI, mermaid, image modals
    render-helpers.ts        # Shared: makeClickable, fence, stripFenceMarkers, normalizeMarkdown, etc.
    summary-renderer.ts      # Dashboard panel (hero cards, charts, metadata)
    system-events-renderer.ts # System events panel (hooks, skills, task reminders)
    tool-renderer.ts         # Tool-specific rendering (Bash, Edit, Write, Read, Agent, AskUserQuestion, ToolSearch)
    search-view.ts           # Dual-mode search panel (cross-session / in-session)
    session-browser-modal.ts # SuggestModal with cached session index
    file-picker-modal.ts     # Import via drag-drop or path
    export-modal.ts          # Export options modal (summary/events toggles, persistent)
  exporters/
    html-exporter.ts         # DOM snapshot → standalone HTML, conditional summary/events
    css-capture.ts           # Theme/app/plugin CSS extraction
    standalone-player.ts     # Embedded JS for exported HTML interactivity
    markdown-exporter.ts     # Markdown with rich frontmatter, summary, system events, tool rendering
  distill/
    distill-session.ts       # Distill orchestrator (extract → find → merge → write)
    extract-frontmatter.ts   # Session stats → YAML frontmatter
    serialize-frontmatter.ts # Frontmatter serialization/parsing
    build-note.ts            # Note content generation + merge logic
    find-existing.ts         # Existing note lookup by session_id
    bases-templates.ts       # Obsidian Bases dashboard templates
    types.ts                 # DistilledFrontmatter, SessionType, DistillOptions
  utils/
    path-utils.ts            # expandHome, basename, dirname, shortenPath
    rate-limits.ts           # OAuth credential reading + Anthropic usage API (beta)
    session-index.ts         # Persistent metadata cache (JSON on disk)
    session-search.ts        # Line-by-line JSONL grep + BM25-ranked search
    bm25.ts                  # BM25 relevance scoring engine (tokenizer, stemmer, index)
    streaming-reader.ts      # File I/O (Node.js streams, metadata extraction)
    logger.ts                # Configurable log levels