claude-code-log 0.3.0__tar.gz → 0.3.2__tar.gz

claude_code_log-0.3.2/.claude/settings.json.bak

@@ -0,0 +1,38 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uv run ruff format"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uv run ruff check --fix"
+          },
+          {
+            "type": "command",
+            "command": "uv run ty check"
+          },
+          {
+            "type": "command",
+            "command": "uv run pyright"
+          },
+          {
+            "type": "command",
+            "command": "uv run pytest"
+          }
+        ]
+      }
+    ]
+  }
+}

{claude_code_log-0.3.0 → claude_code_log-0.3.2}/.claude/settings.local.json

@@ -42,7 +42,8 @@
       "Bash(open /tmp/timeline_test.html)",
       "Bash(touch:*)",
       "Bash(open /Users/dain/workspace/claude-code-log/timeline_style_guide.html)",
-      "Bash(open:*)"
+      "Bash(open:*)",
+      "Bash(git checkout:*)"
     ],
     "deny": []
   }

{claude_code_log-0.3.0 → claude_code_log-0.3.2}/.github/workflows/ci.yml

@@ -24,7 +24,7 @@ jobs:
       run: uv python install ${{ matrix.python-version }}
 
     - name: Install dependencies
-      run: uv sync --all-extras --dev
+      run: uv sync --all-extras --dev && uv run playwright install chromium
 
     - name: Run tests with coverage
       run: uv run pytest --cov=claude_code_log --cov-report=xml --cov-report=html --cov-report=term

{claude_code_log-0.3.0 → claude_code_log-0.3.2}/CHANGELOG.md

@@ -6,6 +6,25 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [0.3.2] - 2025-07-03
+
+### Changed
+
+- **Fix initial message lookup for session boxes + only show one hour of timeline to decrease initialisation time**
+- **Fix lint issue**
+- **Fix sidechain issues in timeline and add to filters + add Playwright browser testing**
+- **Docs update**
+- **Use Anthropic Python SDK for parsing types + handle sub-assistant and system messages**
+- **Fix broken test + add ty and fix type errors**
+
+
+## [0.3.1] - 2025-07-01
+
+### Changed
+
+- **Timeline tooltips + dead code cleanup**
+
+
 ## [0.3.0] - 2025-06-29
 
 ### Changed

{claude_code_log-0.3.0 → claude_code_log-0.3.2}/CLAUDE.md

@@ -8,25 +8,58 @@ This tool processes Claude Code transcript files (stored as JSONL) and generates
 
 ## Key Features
 
-- **Single File or Directory Processing**: Convert individual JSONL files or entire directories
-- **Chronological Ordering**: All messages sorted by timestamp across sessions
+- **Project Hierarchy Processing**: Process entire `~/.claude/projects/` directory with linked index page
+- **Individual Session Files**: Generate separate HTML files for each session with navigation links
+- **Single File or Directory Processing**: Convert individual JSONL files or specific directories
 - **Session Navigation**: Interactive table of contents with session summaries and quick navigation
 - **Token Usage Tracking**: Display token consumption for individual messages and session totals
-- **Timestamp Ranges**: Show first-to-last timestamp ranges for each session in navigation
-- **Rich Message Types**: Support for user/assistant messages, tool use/results, thinking content, images
+- **Runtime Message Filtering**: JavaScript-powered filtering to show/hide message types (user, assistant, system, tool use, etc.)
+- **Chronological Ordering**: All messages sorted by timestamp across sessions
+- **Cross-Session Summary Matching**: Properly match async-generated summaries to their original sessions
 - **Date Range Filtering**: Filter messages by date range using natural language (e.g., "today", "yesterday", "last week")
-- **Markdown Rendering**: Client-side markdown rendering with syntax highlighting
-- **Floating Navigation**: Always-available back-to-top button for easy navigation
-- **Space-Efficient Layout**: Compact design optimized for content density
+- **Rich Message Types**: Support for user/assistant messages, tool use/results, thinking content, images
+- **System Command Visibility**: Show system commands (like `init`) in expandable details with structured parsing
+- **Markdown Rendering**: Server-side markdown rendering with syntax highlighting using mistune
+- **Interactive Timeline**: Optional vis-timeline visualization showing message chronology across all types, with click-to-scroll navigation (implemented in JavaScript within the HTML template)
+- **Floating Navigation**: Always-available back-to-top button and filter controls
+- **Space-Efficient Layout**: Compact design optimised for content density
 - **CLI Interface**: Simple command-line tool using Click
 
 ## Usage
 
+### Default Behavior (Process All Projects)
+
+```bash
+# Process all projects in ~/.claude/projects/ (default behavior)
+claude-code-log
+
+# Explicitly process all projects
+claude-code-log --all-projects
+
+# Process all projects and open in browser
+claude-code-log --open-browser
+
+# Process all projects with date filtering
+claude-code-log --from-date "yesterday" --to-date "today"
+claude-code-log --from-date "last week"
+
+# Skip individual session files (only create combined transcripts)
+claude-code-log --no-individual-sessions
+```
+
+This creates:
+
+- `~/.claude/projects/index.html` - Master index with project cards and statistics
+- `~/.claude/projects/project-name/combined_transcripts.html` - Individual project pages
+- `~/.claude/projects/project-name/session-{session-id}.html` - Individual session pages
+
+### Single File or Directory Processing
+
 ```bash
 # Single file
 claude-code-log transcript.jsonl
 
-# Entire directory
+# Specific directory
 claude-code-log /path/to/transcript/directory
 
 # Custom output location
@@ -37,8 +70,6 @@ claude-code-log /path/to/directory --open-browser
 
 # Filter by date range (supports natural language)
 claude-code-log /path/to/directory --from-date "yesterday" --to-date "today"
-claude-code-log /path/to/directory --from-date "last week"
-claude-code-log /path/to/directory --to-date "2025-06-01"
 claude-code-log /path/to/directory --from-date "3 days ago" --to-date "yesterday"
 ```
 
@@ -47,7 +78,7 @@ claude-code-log /path/to/directory --from-date "3 days ago" --to-date "yesterday
 - `claude_code_log/parser.py` - Data extraction and parsing from JSONL files
 - `claude_code_log/renderer.py` - HTML generation and template rendering
 - `claude_code_log/converter.py` - High-level conversion orchestration
-- `claude_code_log/cli.py` - Command-line interface
+- `claude_code_log/cli.py` - Command-line interface with project discovery
 - `claude_code_log/models.py` - Pydantic models for transcript data structures
 - `claude_code_log/templates/` - Jinja2 HTML templates
   - `transcript.html` - Main transcript viewer template
@@ -58,13 +89,14 @@ claude-code-log /path/to/directory --from-date "3 days ago" --to-date "yesterday
 
 The project uses:
 
-- Python 3.12+
-- Click for CLI interface
-- Pydantic for data validation and parsing
+- Python 3.12+ with uv package management
+- Click for CLI interface and argument parsing
+- Pydantic for robust data modelling and validation
 - Jinja2 for HTML template rendering
 - dateparser for natural language date parsing
 - Standard library for JSON/HTML processing
-- Client-side: marked.js for markdown rendering
+- Minimal dependencies for portability
+- mistune for quick Markdown rendering
 
 ## Development Commands
 
@@ -76,6 +108,12 @@ Run tests with:
 uv run pytest
 ```
 
+The test suite includes both unit tests and browser-based integration tests using Playwright. Timeline functionality is tested in real browsers to ensure JavaScript components work correctly. Playwright tests require Chromium to be installed:
+
+```bash
+uv run playwright install chromium
+```
+
 ### Test Coverage
 
 Generate test coverage reports:
@@ -97,7 +135,7 @@ HTML coverage reports are generated in `htmlcov/index.html`.
 
 - **Format code**: `ruff format`
 - **Lint and fix**: `ruff check --fix`
-- **Type checking**: `uv run pyright`
+- **Type checking**: `uv run pyright` and `uv run ty check`
 
 ### Testing & Style Guide
 
@@ -138,3 +176,7 @@ Uses Jinja2 templates for HTML generation:
 - **Summary Attachment**: Links session summaries via leafUuid -> message UUID -> session ID mapping
 - **Timestamp Tracking**: Records first and last timestamp for each session
 - **Navigation**: Generates clickable ToC with session previews and metadata
+
+### Timeline Component
+
+The interactive timeline is implemented in JavaScript within `claude_code_log/templates/components/timeline.html`. It parses message types from CSS classes generated by the Python renderer. **Important**: When adding new message types or modifying CSS class generation in `renderer.py`, ensure the timeline's message type detection logic is updated accordingly to maintain feature parity. Also, make sure that the filter is still applied consistently to the messages both in the main transcript and in the timeline. You can use Playwright to test browser runtime features.

{claude_code_log-0.3.0 → claude_code_log-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-log
-Version: 0.3.0
+Version: 0.3.2
 Summary: Convert Claude Code transcript JSONL files to HTML
 Project-URL: Homepage, https://github.com/daaain/claude-code-log
 Project-URL: Issues, https://github.com/daaain/claude-code-log/issues
@@ -10,6 +10,7 @@ License-File: LICENSE
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.12
+Requires-Dist: anthropic>=0.56.0
 Requires-Dist: click>=8.0.0
 Requires-Dist: dateparser>=1.0.0
 Requires-Dist: jinja2>=3.0.0
@@ -48,15 +49,28 @@ uvx claude-code-log --open-browser
 - **Token Usage Tracking**: Display token consumption for individual messages and session totals
 - **Runtime Message Filtering**: JavaScript-powered filtering to show/hide message types (user, assistant, system, tool use, etc.)
 - **Chronological Ordering**: All messages sorted by timestamp across sessions
+- **Interactive timeline**: Generate an interactive, zoomable timeline grouped by message times to navigate conversations visually
 - **Cross-Session Summary Matching**: Properly match async-generated summaries to their original sessions
 - **Date Range Filtering**: Filter messages by date range using natural language (e.g., "today", "yesterday", "last week")
 - **Rich Message Types**: Support for user/assistant messages, tool use/results, thinking content, images
 - **System Command Visibility**: Show system commands (like `init`) in expandable details with structured parsing
 - **Markdown Rendering**: Server-side markdown rendering with syntax highlighting using mistune
 - **Floating Navigation**: Always-available back-to-top button and filter controls
-- **Space-Efficient Layout**: Compact design optimized for content density
 - **CLI Interface**: Simple command-line tool using Click
 
+## What Problems Does This Solve?
+
+This tool helps you answer questions like:
+
+- **"How can I review all my Claude Code conversations?"**
+- **"What did I work on with Claude yesterday/last week?"**
+- **"How much are my Claude Code sessions costing?"**
+- **"How can I search through my entire Claude Code history?"**
+- **"What tools did Claude use in this project?"**
+- **"How can I share my Claude Code conversation with others?"**
+- **"What's the timeline of my project development?"**
+- **"How can I analyse patterns in my Claude Code usage?"**
+
 ## Usage
 
 ### Default Behavior (Process All Projects)
@@ -71,15 +85,18 @@ claude-code-log --all-projects
 # Process all projects and open in browser
 claude-code-log --open-browser
 
-# Process all projects with date filtering
+# Process all projects with date filtering  
 claude-code-log --from-date "yesterday" --to-date "today"
 claude-code-log --from-date "last week"
+
+# Skip individual session files (only create combined transcripts)
+claude-code-log --no-individual-sessions
 ```
 
 This creates:
 
-- `~/.claude/projects/index.html` - Master index with project cards and statistics
-- `~/.claude/projects/project-name/combined_transcripts.html` - Individual project pages
+- `~/.claude/projects/index.html` - Top level index with project cards and statistics
+- `~/.claude/projects/project-name/combined_transcripts.html` - Individual project pages (these can be several megabytes)
 - `~/.claude/projects/project-name/session-{session-id}.html` - Individual session pages
 
 ### Single File or Directory Processing
@@ -239,10 +256,16 @@ Install using pip:
 pip install claude-code-log
 ```
 
+Or run directly with uvx (no installation required):
+
+```bash
+uvx claude-code-log
+```
+
 Or install from source:
 
 ```bash
-git clone https://github.com/your-username/claude-code-log.git
+git clone https://github.com/daaain/claude-code-log.git
 cd claude-code-log
 uv sync
 uv run claude-code-log
@@ -250,14 +273,10 @@ uv run claude-code-log
 
 ## TODO
 
-- **Timeline view**: Show interaction on a timeline to get a better idea on timings and parallel calls - maybe Timeline.js optionally generated runtime?
-- document what questions does this library help answering
 - integrate `claude-trace` request logs if present?
-- use Anthropic's own types: <https://github.com/anthropics/anthropic-sdk-python/tree/main/src/anthropic/types> – can these be used to generate Pydantic classes though?
 - Shortcut / command to resume a specific conversation by session ID $ claude --resume 550e8400-e29b-41d4-a716-446655440000?
 - Localised number formatting and timezone adjustment runtime? For this we'd need to make Jinja template variables more granular
 - get `cwd` from logs to be able to render the proper path for titles
-- handle `"isSidechain":true` for sub-agent Tasks
 - convert images to WebP as screenshots are often huge PNGs – this might be time consuming to keep redoing (so would also need some caching) and need heavy dependencies with compilation (unless there are fast pure Python conversation libraries? Or WASM?)
 - add special formatting for built-in tools: Bash, Glob, Grep, LS, exit_plan_mode, Read, Edit, MultiEdit, Write, NotebookRead, NotebookEdit, WebFetch, TodoRead, TodoWrite, WebSearch
   - render Edit / MultiEdit as diff(s)?
@@ -265,4 +284,4 @@ uv run claude-code-log
 - Thinking block should have Markdown rendering as sometimes they have formatting
 - system blocks like `init` also don't render perfectly, losing new lines
 - add `ccusage` like daily summary and maybe some textual summary too based on Claude generate session summaries?
-- handle model change system message
+– import logs from @claude Github Actions

{claude_code_log-0.3.0 → claude_code_log-0.3.2}/README.md

@@ -29,15 +29,28 @@ uvx claude-code-log --open-browser
 - **Token Usage Tracking**: Display token consumption for individual messages and session totals
 - **Runtime Message Filtering**: JavaScript-powered filtering to show/hide message types (user, assistant, system, tool use, etc.)
 - **Chronological Ordering**: All messages sorted by timestamp across sessions
+- **Interactive timeline**: Generate an interactive, zoomable timeline grouped by message times to navigate conversations visually
 - **Cross-Session Summary Matching**: Properly match async-generated summaries to their original sessions
 - **Date Range Filtering**: Filter messages by date range using natural language (e.g., "today", "yesterday", "last week")
 - **Rich Message Types**: Support for user/assistant messages, tool use/results, thinking content, images
 - **System Command Visibility**: Show system commands (like `init`) in expandable details with structured parsing
 - **Markdown Rendering**: Server-side markdown rendering with syntax highlighting using mistune
 - **Floating Navigation**: Always-available back-to-top button and filter controls
-- **Space-Efficient Layout**: Compact design optimized for content density
 - **CLI Interface**: Simple command-line tool using Click
 
+## What Problems Does This Solve?
+
+This tool helps you answer questions like:
+
+- **"How can I review all my Claude Code conversations?"**
+- **"What did I work on with Claude yesterday/last week?"**
+- **"How much are my Claude Code sessions costing?"**
+- **"How can I search through my entire Claude Code history?"**
+- **"What tools did Claude use in this project?"**
+- **"How can I share my Claude Code conversation with others?"**
+- **"What's the timeline of my project development?"**
+- **"How can I analyse patterns in my Claude Code usage?"**
+
 ## Usage
 
 ### Default Behavior (Process All Projects)
@@ -52,15 +65,18 @@ claude-code-log --all-projects
 # Process all projects and open in browser
 claude-code-log --open-browser
 
-# Process all projects with date filtering
+# Process all projects with date filtering  
 claude-code-log --from-date "yesterday" --to-date "today"
 claude-code-log --from-date "last week"
+
+# Skip individual session files (only create combined transcripts)
+claude-code-log --no-individual-sessions
 ```
 
 This creates:
 
-- `~/.claude/projects/index.html` - Master index with project cards and statistics
-- `~/.claude/projects/project-name/combined_transcripts.html` - Individual project pages
+- `~/.claude/projects/index.html` - Top level index with project cards and statistics
+- `~/.claude/projects/project-name/combined_transcripts.html` - Individual project pages (these can be several megabytes)
 - `~/.claude/projects/project-name/session-{session-id}.html` - Individual session pages
 
 ### Single File or Directory Processing
@@ -220,10 +236,16 @@ Install using pip:
 pip install claude-code-log
 ```
 
+Or run directly with uvx (no installation required):
+
+```bash
+uvx claude-code-log
+```
+
 Or install from source:
 
 ```bash
-git clone https://github.com/your-username/claude-code-log.git
+git clone https://github.com/daaain/claude-code-log.git
 cd claude-code-log
 uv sync
 uv run claude-code-log
@@ -231,14 +253,10 @@ uv run claude-code-log
 
 ## TODO
 
-- **Timeline view**: Show interaction on a timeline to get a better idea on timings and parallel calls - maybe Timeline.js optionally generated runtime?
-- document what questions does this library help answering
 - integrate `claude-trace` request logs if present?
-- use Anthropic's own types: <https://github.com/anthropics/anthropic-sdk-python/tree/main/src/anthropic/types> – can these be used to generate Pydantic classes though?
 - Shortcut / command to resume a specific conversation by session ID $ claude --resume 550e8400-e29b-41d4-a716-446655440000?
 - Localised number formatting and timezone adjustment runtime? For this we'd need to make Jinja template variables more granular
 - get `cwd` from logs to be able to render the proper path for titles
-- handle `"isSidechain":true` for sub-agent Tasks
 - convert images to WebP as screenshots are often huge PNGs – this might be time consuming to keep redoing (so would also need some caching) and need heavy dependencies with compilation (unless there are fast pure Python conversation libraries? Or WASM?)
 - add special formatting for built-in tools: Bash, Glob, Grep, LS, exit_plan_mode, Read, Edit, MultiEdit, Write, NotebookRead, NotebookEdit, WebFetch, TodoRead, TodoWrite, WebSearch
   - render Edit / MultiEdit as diff(s)?
@@ -246,4 +264,4 @@ uv run claude-code-log
 - Thinking block should have Markdown rendering as sometimes they have formatting
 - system blocks like `init` also don't render perfectly, losing new lines
 - add `ccusage` like daily summary and maybe some textual summary too based on Claude generate session summaries?
-- handle model change system message
+– import logs from @claude Github Actions

{claude_code_log-0.3.0 → claude_code_log-0.3.2}/claude_code_log/converter.py

@@ -4,7 +4,7 @@
 from pathlib import Path
 import traceback
 from typing import List, Optional, Dict, Any
-from .utils import should_use_as_session_starter
+from .utils import should_use_as_session_starter, extract_init_command_description
 
 from .parser import (
     load_transcript,
@@ -143,9 +143,10 @@ def _collect_project_sessions(messages: List[TranscriptEntry]) -> List[Dict[str,
             ):
                 first_user_content = extract_text_content(message.message.content)
                 if should_use_as_session_starter(first_user_content):
-                    sessions[session_id]["first_user_message"] = first_user_content[
-                        :500
-                    ]
+                    preview_content = extract_init_command_description(
+                        first_user_content
+                    )
+                    sessions[session_id]["first_user_message"] = preview_content[:500]
 
     # Convert to list format with formatted timestamps
     session_list: List[Dict[str, Any]] = []