Pr 39

README.md

@@ -5,7 +5,7 @@
 [![Tests](https://github.com/simonw/claude-code-transcripts/workflows/Test/badge.svg)](https://github.com/simonw/claude-code-transcripts/actions?query=workflow%3ATest)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/simonw/claude-code-transcripts/blob/main/LICENSE)
 
-Convert Claude Code session files (JSON or JSONL) to clean, mobile-friendly HTML pages with pagination.
+Convert Claude Code and Codex CLI session files (JSON or JSONL) to clean, mobile-friendly HTML pages with pagination.
 
 [Example transcript](https://static.simonwillison.net/static/2025/claude-code-microjs/index.html) produced using this tool.
 
@@ -24,11 +24,17 @@ uvx claude-code-transcripts --help
 
 ## Usage
 
-This tool converts Claude Code session files into browseable multi-page HTML transcripts.
+This tool converts Claude Code and Codex CLI session files into browseable multi-page HTML transcripts.
+
+**Supported formats:**
+- Claude Code session files (JSONL format from `~/.claude/projects`)
+- Codex CLI session files (JSONL format from `~/.codex/sessions`) - automatically detected and converted
+- Kiro CLI saved chat sessions (JSON export from `/save session.json`) - automatically detected and converted
+
 
 There are four commands available:
 
-- `local` (default) - select from local Claude Code sessions stored in `~/.claude/projects`
+- `local` (default) - select from local sessions (Claude Code from `~/.claude/projects` and Codex CLI from `~/.codex/sessions`)
 - `web` - select from web sessions via the Claude API
 - `json` - convert a specific JSON or JSONL session file
 - `all` - convert all local sessions to a browsable HTML archive
@@ -39,7 +45,7 @@ The quickest way to view a recent local session:
 claude-code-transcripts
 ```
 
-This shows an interactive picker to select a session, generates HTML, and opens it in your default browser.
+This shows an interactive picker with sessions from both Claude Code and Codex CLI, clearly labeled by source. Select any session to generate HTML and open it in your browser.
 
 ### Output options
 
@@ -56,6 +62,8 @@ The generated output includes:
 - `index.html` - an index page with a timeline of prompts and commits
 - `page-001.html`, `page-002.html`, etc. - paginated transcript pages
 
+Transcript pages include a left sidebar with filter toggles (user/assistant/tools/tool results/thinking) and an in-page outline of turns. Filter settings persist across pages using `localStorage`.
+
 ### Local sessions
 
 Local Claude Code sessions are stored as JSONL files in `~/.claude/projects`. Run with no arguments to select from recent sessions:
@@ -151,10 +159,18 @@ Convert a specific session file directly:
 claude-code-transcripts json session.json -o output-directory/
 claude-code-transcripts json session.jsonl --open
 ```
-This works with both JSONL files in the `~/.claude/projects/` folder and JSON session files extracted from Claude Code for web.
+This works with JSONL files in the `~/.claude/projects/` folder, JSON session files extracted from Claude Code for web, and Kiro CLI saved sessions (created using `/save session.json`).
 
 The `json` command can take a URL to a JSON or JSONL file as an alternative to a path on disk.
 
+### Antigravity exports
+
+This tool supports Antigravity conversation export JSON files. Export a conversation from Antigravity as JSON, then run:
+
+```bash
+claude-code-transcripts json path/to/export.json
+```
+
 ### Converting all sessions
 
 Convert all your local Claude Code sessions to a browsable HTML archive:

pyproject.toml

@@ -32,6 +32,7 @@ build-backend = "uv_build"
 
 [dependency-groups]
 dev = [
+
     "pytest>=9.0.2",
     "pytest-httpx>=0.35.0",
     "syrupy>=5.0.0",