jsonl session log parsing with per-turn reconstruction
Parses Claude Code's JSONL session files stored at ~/.claude/projects/ to reconstruct the complete execution trace of each turn, including file reads, tool calls, token consumption, and context injections. Uses a streaming JSONL parser with caching strategy to handle large session files efficiently without loading entire logs into memory, enabling post-hoc analysis of sessions regardless of execution environment (terminal, IDE, or wrapper tool).
Unique: Implements streaming JSONL parsing with multi-level caching (file-level and turn-level) to reconstruct per-turn context windows without requiring full session file loads, combined with path encoding scheme (Project IDs) to handle complex project hierarchies and remote SSH paths uniformly
vs alternatives: Provides deeper execution visibility than Claude Code's native --verbose output by structuring raw logs into queryable turn-by-turn traces, while avoiding the terminal flooding and raw JSON noise of verbose mode
context window composition analysis with token attribution
Reverse-engineers the per-turn context window contents by analyzing session logs and attributing tokens across discrete categories: CLAUDE.md files, skill activations, tool I/O, thinking blocks, and system prompts. Uses a token accounting system that maps each context component back to its source in the session log, enabling developers to understand exactly why the context window grew or shrank at each step.
Unique: Implements a multi-category token attribution system that maps context components back to their source in session logs, using Claude's tokenizer to provide accurate per-category breakdowns rather than opaque aggregate counts, combined with skill activation tracking to identify unused context
vs alternatives: Provides granular context breakdown that Claude Code's native three-segment context bar cannot show, enabling developers to make informed decisions about project structure and skill organization
auto-update system with code signing and notarization
Implements an auto-update mechanism using Electron's update framework with code signing (macOS) and notarization to ensure app integrity. Detects new releases from GitHub, downloads updates in the background, and prompts users to install with a visual dialog. Supports staged rollouts and rollback on update failures.
Unique: Implements Electron auto-update with code signing and macOS notarization to ensure update integrity, combined with a visual update dialog and support for deferred installation, enabling secure background updates
vs alternatives: Provides automatic, secure updates with code signing and notarization, whereas manual downloads require user intervention and lack integrity verification
project scanner with path encoding and unified project id system
Scans the Claude projects directory to discover all projects and their sessions, using a path encoding scheme that creates stable Project IDs from file paths. Handles both local paths and remote SSH paths uniformly, enabling a single project ID to reference sessions across different machines. Caches project metadata to avoid repeated directory scans.
Unique: Implements a path encoding scheme that creates stable, deterministic Project IDs from file paths, enabling unified project identification across local and remote machines, combined with metadata caching to optimize repeated discovery
vs alternatives: Provides a unified project namespace across local and remote machines using stable Project IDs, whereas naive approaches would require separate project lists per machine or complex path mapping
ssh remote session inspection with sftp file operations
Connects to remote machines via SSH/SFTP to discover and parse Claude Code sessions running on remote servers, enabling inspection of remote session logs as if they were local. Implements an SSH Connection Manager that handles authentication (key-based and password), remote path resolution, and transparent SFTP file operations, with a caching layer to avoid repeated remote file transfers. Supports multi-machine setups where developers run Claude Code on different servers.
Unique: Implements a dedicated SSH Connection Manager with transparent SFTP file operations and multi-level caching (connection pooling, file content caching) to minimize latency, combined with path encoding scheme that unifies local and remote paths under a single Project ID system
vs alternatives: Eliminates manual SSH workflows for inspecting remote Claude Code sessions by providing a unified UI for both local and remote sessions, with automatic connection management and caching to reduce network overhead
real-time session discovery and auto-refresh with file system watching
Monitors the ~/.claude/projects/ directory (local and remote) for new or updated session files using file system watchers, automatically discovering new sessions and refreshing existing session data without requiring manual refresh. Implements a Project Scanner that enumerates project directories, detects new sessions, and triggers incremental JSONL parsing for updated files. Uses debouncing and throttling to prevent excessive re-parsing during rapid file writes.
Unique: Combines native file system watchers (local) with SFTP polling (remote) and implements debouncing/throttling at the parsing layer to prevent UI thrashing, using incremental JSONL parsing to update only changed turns rather than re-parsing entire sessions
vs alternatives: Provides live session visibility without manual refresh, unlike static log viewers that require explicit reload, while avoiding the resource overhead of naive file watching by implementing intelligent debouncing and incremental parsing
interactive session timeline and turn-by-turn inspection ui
Renders a visual timeline of session turns with expandable details for each turn, showing tool calls, file reads, token consumption, and context state. Implements a React-based UI with virtualization to handle sessions with hundreds of turns efficiently, combined with a command palette for quick navigation and filtering. Each turn can be expanded to show full tool call arguments, results, and context composition.
Unique: Implements React virtualization to render hundreds of turns efficiently without loading entire session into DOM, combined with a command palette for keyboard-driven navigation and a collapsible turn structure that shows context composition at each step
vs alternatives: Provides interactive, searchable session inspection in a native desktop UI rather than raw JSON or terminal output, with virtualization enabling smooth navigation through large sessions that would be unwieldy in text editors
notification system with custom trigger rules and filtering
Implements a configurable notification system that triggers alerts based on session events (e.g., tool call failures, context window near capacity, session completion). Uses a Notification Manager with a trigger system that evaluates conditions against session data and supports filtering/throttling to prevent notification spam. Notifications can be configured per-project or globally, with support for custom trigger expressions.
Unique: Implements a declarative trigger system with filtering and throttling that evaluates conditions against parsed session data, supporting both built-in triggers (completion, failure, context threshold) and custom expressions, with per-project configuration
vs alternatives: Provides proactive monitoring of Claude Code sessions without requiring manual polling, with configurable triggers and filtering to reduce alert fatigue compared to naive notification systems
+4 more capabilities