Skip to content

Conversation

@skinner84
Copy link

@skinner84 skinner84 commented Jan 2, 2026

Hi Simon,

I'm a recent follower of your blog. Having recently joined a cloud security company, I needed to up my game on all things software development. Your blog has been a great source of information for me so thank you.

I don't have a developer background (I come from Cybercecurity/Network Engineering), but thanks to vibe coding I did most of this from my phone as I had a need to look at Codex CLI history for a blog post I am writing. What a time to be alive.

Feel free to reject, this is my first PR, but I've learned a lot about Git in the process. Thanks again.

Summary

  • Add Codex CLI JSONL support alongside Claude Code (auto-detect format and normalize).
  • Parse older Codex “rollout” format (message/function_call/function_call_output) and map tools/results correctly.
  • Improve session summaries by skipping AGENTS preamble; sanitize Codex fixture and remove local artifacts.
  • Added Codex-specific tests/fixtures (tests/test_codex_format.py, tests/test_codex_cli_finder.py, tests/sample_codex_session.jsonl) and a summary preamble test in tests/test_generate_html.py.

claude and others added 5 commits January 2, 2026 22:57
- Implemented format detection to distinguish between Claude Code and Codex CLI JSONL files
- Created parser to convert Codex CLI format (session_meta, response_item, function_call) to Claude Code format
- Added tool name mapping (shell_command -> Bash, read_file -> Read, etc.)
- Added comprehensive test suite with 7 tests covering format detection, message parsing, and HTML generation
- Updated documentation to mention Codex CLI support
- All 118 tests passing (111 existing + 7 new)

The tool now automatically detects and handles both formats seamlessly, making it easy to generate HTML transcripts from either Claude Code or Codex CLI session files.
- Implemented find_combined_sessions() to search both ~/.claude/projects and ~/.codex/sessions
- Updated get_session_summary() to extract summaries from Codex CLI format (response_item payloads)
- Modified local command to show sessions from both sources with clear [Claude] and [Codex] labels
- Sessions are sorted together by modification time across both sources
- Added 5 comprehensive tests for combined session finder
- Updated documentation to reflect unified picker functionality

Users can now run `claude-code-transcripts` and see an interactive picker showing:
  2025-01-02 10:00  245 KB  [Claude]  Fix authentication bug
  2025-01-01 14:30  189 KB  [Codex ]  Add dark mode feature
  2025-01-01 09:15  312 KB  [Claude]  Refactor API endpoints

All 123 tests passing (111 original + 7 Codex format + 5 Codex finder).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants