Session Analyzer v0.2.0

Session Analyzer 0.2.0 expands local session review across sources, adds a new way to navigate tool-heavy conversations, and substantially reworks how large session histories are indexed and loaded.

Highlights

Trajectory presentation

A new optional Trajectory view is available alongside the default Timeline. It provides a compact Input / Model / Tools sequence overview with zoom, pan, and fit controls, while keeping the conversation itself readable in a narrative-first layout. Tool activity can be grouped and expanded without losing access to the underlying events and details.

DeepSeek Harness support

DeepSeek Harness is now available as a third transcript source alongside Codex and Claude Code.

Session Analyzer can read supported DeepSeek JSONL and Zstandard session histories locally, with structured coverage for session and tool lifecycles, lineage and derived sessions, compaction, Code Mode and workflow provenance, retries, Goal/Todo state, permissions, and related recorded metadata. Unsupported event families remain inspectable through Protocol and Raw records.

npx session-analyzer@0.2.0 --source deepseek-harness

Scalable session loading

Codex and Claude Code histories now use a stricter Indexed / Materialized Session model. The project index keeps compact information for browsing and search, while complete sessions are reconstructed from their source only when needed.

This reduces the need to keep every complete session graph resident in memory and improves behavior with large transcript histories. Materialized sessions are retained through a bounded cache with request coalescing, controlled reconstruction, cancellation handling, and bounded prewarming.

Codex improvements

• Improved parent linkage for explicitly derived and subagent sessions.
• Improved declared Code Mode projection and command labeling.
• Added per-request Token usage presentation.
• Added conservative cache-reuse discontinuity observations with supporting Protocol evidence. These observations do not claim explicit cache expiry or expose hidden server-side cache state.

Getting started

Codex remains the default source:

npx session-analyzer@0.2.0

Claude Code:

npx session-analyzer@0.2.0 --source claude-code

DeepSeek Harness:

npx session-analyzer@0.2.0 --source deepseek-harness

Then open http://127.0.0.1:17890/ in your browser.

Session Analyzer reads existing transcripts locally and does not modify or upload their contents.

Requirements

• Node.js 22 or later
• Node.js 24 recommended
• Reading DeepSeek Zstandard session files requires Node's built-in Zstandard support

See the README and CHANGELOG for source-specific behavior, boundaries, and the complete list of changes in 0.2.0.