Skip to content

Codex CLI Support #39

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
skinner84 wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Codex CLI Support #39

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
871966d
Add Codex CLI format support with automatic detection
claude Jan 2, 2026
9b8a62e
Add unified session picker for both Claude Code and Codex CLI
claude Jan 2, 2026
f7c8f69
Handle old Codex CLI session format
skinner84 Jan 2, 2026
e3d2b3e
Skip AGENTS preambles in session summaries
skinner84 Jan 2, 2026
fed5203
Remove local session artifacts and sanitize codex fixture
skinner84 Jan 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -24,11 +24,15 @@ 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

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
Expand All @@ -39,7 +43,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

Expand Down
Loading