codex-export-tool 0.2.1

Export Codex session logs to a self-contained, browsable static HTML site (ZIP archive)

codex-export-tool

Export Codex session logs to a self-contained, browsable static HTML site.

Installation

pip install codex-export-tool

Or from source:

git clone <repo-url>
cd codex-export-tool
pip install -e .

Windows setup

After pip install codex-export-tool, if the command is not found, the Python Scripts folder is not in your system PATH.

Option A -- Add to PATH (recommended) Run PowerShell as Administrator and paste:

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", "User") +
    ";C:\Users\poon9\AppData\Local\Programs\Python\Python312\Scripts",
    "User"
)

Restart your terminal -- codex-export-tool will work anywhere.

Option B -- Use python -m (no PATH change needed)

python -m codex_export

Both options work identically.

Usage

Interactive mode

codex-export-tool

Shows a list of available sessions, then lets you pick records to export.

Non-interactive mode

# Export entire session by ID
codex-export-tool --session <session-id>

# Custom output path
codex-export-tool --output my_export.zip

# Standalone HTML (no ZIP)
codex-export-tool --session <session-id> --format html

# Open in browser after export
codex-export-tool --session <session-id> --open

# Filter by role
codex-export-tool --session <session-id> --role user
codex-export-tool --session <session-id> --role assistant

# Exclude file diffs
codex-export-tool --session <session-id> --no-diffs

# Time range filter
codex-export-tool --session <session-id> --after "2026-01-01T00:00:00Z" --before "2026-06-01T00:00:00Z"

# Custom session directory
codex-export-tool --session-dir ~/custom/sessions

Output

The output is a ZIP archive (or standalone HTML with --format html). Extract the ZIP and open index.html in any modern browser.

Features

• Turn structure — Messages are grouped into conversational turns for easy reading
• TOC sidebar — Jump between turns from the sidebar (mobile-friendly toggle)
• File diffs — File edits shown with green (add) / red (delete) highlighting
• Dark mode — Toggle with toolbar button or t key; follows system preference
• Search — Real-time full-text search with highlighted matches
• Copy buttons — One-click copy for code blocks
• Keyboard shortcuts — j/k for navigation, / for search, t for dark mode, ? for help

Configuration

Add a .codex-export.toml file in your home or project directory:

[display]
date_format = "%Y-%m-%d %H:%M:%S"
summary_length = 60

[export]
max_file_size_kb = 200
max_diff_lines = 500

License

MIT