claudexer 0.4.0__tar.gz

claudexer-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 matplo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

claudexer-0.4.0/MANIFEST.in

@@ -0,0 +1,9 @@
+include README.md
+include pyproject.toml
+include LICENSE
+recursive-include src/codex_export *.py *.css *.js
+recursive-include tests *.py
+recursive-include examples *.jsonl
+recursive-include scripts *.py
+prune exports
+global-exclude __pycache__ *.py[cod] .DS_Store

claudexer-0.4.0/PKG-INFO

@@ -0,0 +1,272 @@
+Metadata-Version: 2.4
+Name: claudexer
+Version: 0.4.0
+Summary: Browse, resume, and export Codex and Claude Code sessions with a Textual picker
+Author: matplo
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/matplo/claudexer
+Project-URL: Repository, https://github.com/matplo/claudexer
+Project-URL: Issues, https://github.com/matplo/claudexer/issues
+Project-URL: Changelog, https://github.com/matplo/claudexer/releases
+Keywords: codex,claude,sessions,markdown,html,textual,resume
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: markdown-it-py<5,>=3
+Requires-Dist: Pygments<3,>=2.17
+Requires-Dist: textual<9,>=8.2
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Dynamic: license-file
+
+# Claudexer
+
+Browse local Codex and Claude Code sessions, resume one where you left off, or
+export it to readable **standalone HTML** or **Markdown**. Run `claudexer`
+without a filename to browse both providers in a full-screen Textual picker.
+Preview the first and last 10 user prompts before choosing a session.
+
+This project was previously published as `claudex-export`; see its
+[final release notes](https://pypi.org/project/claudex-export/) if you're
+migrating from that name.
+
+In the Textual picker, `Enter` resumes the selected session by exec'ing
+`claude --resume ID` or `codex resume ID` (whichever binary the session
+belongs to must be on `PATH`, and it runs from the session's original working
+directory when known). Press `e` to export instead; a modal reports the
+written file(s) or any error without leaving the picker.
+
+**Exports are sanitized by default.** They contain the session date, title,
+recorded elapsed time when available, direct user prompts, and assistant
+progress/final replies. Tools, execution plans, injected context, images,
+session IDs, working directories, and individual message timestamps are omitted.
+Use `--full` to restore the previous detailed transcript, or press `f` in the
+Textual picker or preview to toggle between sanitized and full export.
+
+Requires Python 3.10 or later. No API key or service is needed.
+
+## Install
+
+```bash
+python -m pip install claudexer
+```
+
+Or install it as an isolated command-line application with
+`pipx install claudexer`. Python and its dependencies are sufficient; `henv` is
+only used for development in this repository.
+
+## Usage
+
+```bash
+# Browse and search local sessions; HTML is the default
+claudexer
+
+# Browse only Claude Code sessions
+claudexer --source claude
+
+# Auto-detect a Claude Code file and export both formats
+claudexer /path/to/claude-session.jsonl --format both -o exports
+
+# Opt in to metadata, original messages, tool details, and images
+claudexer /path/to/session.jsonl --full -o detailed.html
+
+# Remove additional names or literal strings from sanitized output
+claudexer /path/to/session.jsonl --redact 'Jane Doe' --redact 'Acme Private Project'
+
+# Export a specified rollout
+claudexer /path/to/rollout.jsonl -o conversation.html
+
+# Markdown, without tool calls/results
+claudexer /path/to/rollout.jsonl --format md --no-tools -o conversation.md
+
+# Both formats, into a directory
+claudexer /path/to/rollout.jsonl --format both -o exports
+
+# Include archived sessions, or use another Codex home
+claudexer --include-archived
+claudexer --codex-home /path/to/.codex
+```
+
+The Textual picker supports arrow keys, Page Up/Down, and mouse navigation.
+Press `/` to focus live search; search matches titles, directories, IDs, and
+provider names. Enter in the search box returns focus to the results.
+
+| Key | Action |
+| --- | --- |
+| `↑` / `↓` | Move between sessions |
+| `Enter` on a session | Resume it: exec into `claude --resume ID` or `codex resume ID` |
+| `v` | Preview the selected session's user prompts |
+| `e` in list or preview | Export the selected/previewed session; a modal reports the result |
+| `f` in list or preview | Toggle sanitized/full export; current mode is displayed |
+| `Esc` / `v` in preview | Return to the list |
+| `/` | Focus search |
+| `Esc` in list | Clear search and focus the list |
+| `q` / `Ctrl+C` | Cancel |
+
+Previews are scrollable and loaded in a background worker. They follow the selected
+export mode and show prompt text with original numbering: the first 10 and last 10,
+without duplicates where those ranges overlap. For longer sessions a marker
+shows how many middle prompts were omitted. Tool results, injected context, and
+compaction summaries are excluded from the prompt preview. Images are counted,
+not opened. Reading a preview does not write an export.
+
+Use `--plain-picker` for the original numbered terminal picker (`/search`,
+`n`/`p`, number to select, `q` to cancel); prompt previews require the Textual
+picker. Without an interactive terminal, supply an explicit input file.
+
+By default, exports are written to the current directory with the date and a
+redacted title in the filename. Full exports use the original title and session
+ID. `-o` is a file path for a single format and a
+directory for `--format both`. Parent directories are created as needed.
+Existing files require `--force`; the source session is never overwritten.
+
+## Sanitization and full exports
+
+The same defaults apply to HTML and Markdown, including `--format both`.
+Sanitization removes recognizable email addresses, IP/MAC addresses, common
+phone-number formats, UUIDs, local paths, local hostnames, and known identity
+values from metadata and local account information. It also redacts those values
+in titles, prose, and code blocks. Links lose their destinations and image
+payloads are omitted. Generated filenames exclude the session ID and redact the
+title; an explicitly supplied `-o` name is used as given.
+
+This is deterministic, local, **best-effort** redaction. It cannot identify every
+person's name, street address, organization, or other identifying fact in arbitrary
+prose. Review a file before sharing it and supply repeatable `--redact TEXT`
+arguments for additional names or strings. No external service is used.
+
+Elapsed time is the span between recorded timestamps and includes idle time;
+it is omitted if the log does not provide distinct usable timestamps.
+
+`--full` disables sanitization and restores metadata, original conversation text,
+tools, images, and session event markers. `--no-tools` can still suppress tools
+in full mode. `--redact` applies only to sanitized mode. Full mode does not add
+raw system/developer instructions, reasoning, usage records, or unknown records
+that the parser has always excluded. The local picker still displays directories
+and IDs to help identify a session; they are not included in sanitized exports.
+
+## Supported content
+
+- Native Codex rollout and Claude Code `.jsonl` files, containing one JSON
+  record per line. File content determines the format automatically; use
+  `--source codex` or `--source claude` to specify it explicitly.
+- `.json` containing a single native session record or an array of records.
+  Codex records use `type`/`payload`; Claude Code uses `type`/`message` and
+  session metadata. Arbitrary chat JSON formats are not supported.
+- User messages and assistant progress/final replies in recorded order. Tool
+  inputs/results and compaction/interruption markers are included with `--full`.
+- Native transcript records take priority over matching completion events.
+  Duplicates are matched by IDs and by content within each turn, one occurrence
+  at a time. Separate repeated messages remain present.
+- System/developer messages, reasoning, usage records, and replacement history
+  from compaction are omitted. Instructions stored as actual **user** messages
+  remain part of the full transcript. Known injected context is omitted in
+  sanitized mode.
+- Tools invoked inside an orchestration tool may appear as separate execution
+  events as well as in that tool's output: these describe nested operations.
+- Claude Code tool-use blocks pair with tool results by tool-use ID. Replayed
+  UUIDs are deduplicated while separate blocks sharing a message ID survive.
+  Thinking blocks, metadata, and compacted summaries are omitted. End-of-turn
+  replies use the light blue final-answer styling.
+
+HTML includes responsive styling, highlighted code, tables, links, message
+anchors, collapsed tool details, expand/collapse buttons, and a print button.
+It uses embedded CSS/JavaScript and works offline. Printing expands tool details.
+Markdown keeps conversation formatting and uses fenced blocks for tool data.
+
+With `--full`, embedded PNG, JPEG, GIF, and WebP data images are preserved. Other image
+references become placeholders; the exporter does not fetch remote images or
+read image paths from the transcript. Raw HTML is escaped in conversation prose;
+HTML exports restrict scripts and resource loads with a Content Security Policy.
+
+Codex discovery respects `--codex-home`, then `CODEX_HOME`, then `~/.codex`.
+It scans `sessions/` (and optionally `archived_sessions/`) and uses
+`session_index.jsonl` titles when available. Sessions are sorted by recent
+activity. Each export covers one file; child/subagent sessions are not recursively
+included. Claude Code discovery respects `--claude-home`, then
+`CLAUDE_CONFIG_DIR`, then `~/.claude`, and reads main session files under
+`projects/`. Custom or automatic session titles take priority over the first
+prompt. Subagent logs are excluded from discovery; pass a subagent file explicitly
+to export it. `--source all` (the default) combines both providers; archived
+session inclusion applies to Codex. Source files and databases are never modified.
+
+Unknown record types and malformed JSONL lines produce warnings. An incomplete
+final line in a running session is skipped; rerun the export later to include it.
+Local session formats can evolve, so inspect export notes when a newer record type
+appears. Full exports contain the selected conversation and tool data as stored;
+sanitized exports apply the redaction described above.
+
+## Development
+
+```bash
+henv -n export_codex_session_dev -x python -m pip install -e '.[dev]'
+henv -n export_codex_session_dev -x python -m pytest
+```
+
+Tests use synthetic sessions, including headless Textual keyboard/preview tests.
+Keep private session files and generated exports
+out of source control; `exports/` is ignored for local previews.
+
+## Releases to PyPI
+
+Pushing a version tag triggers `.github/workflows/release.yml`. It runs tests
+on Python 3.10–3.14, builds an sdist and wheel, checks package metadata, and
+smoke-tests an installation of the built wheel. The tag must exactly match
+`v` followed by the package version. Only then does it publish to PyPI and
+create a GitHub release with both distribution files attached.
+
+### One-time PyPI setup
+
+In your PyPI account, open [Publishing](https://pypi.org/manage/account/publishing/)
+and add a **pending GitHub publisher** with these exact values:
+
+| Field | Value |
+| --- | --- |
+| PyPI project name | `claudexer` |
+| GitHub owner | `matplo` |
+| Repository | `claudexer` |
+| Workflow filename | `release.yml` |
+| Environment name | `pypi` |
+
+If the PyPI project already exists in your account, add the same publisher
+under that project's Publishing settings. The GitHub workflow uses OIDC
+Trusted Publishing; no `PYPI_API_TOKEN` secret is needed. The GitHub environment
+`pypi` must not require reviewer approval if you want fully automatic releases.
+The PyPI project is created by the first successful publish, not by registering
+the pending publisher.
+
+### Publish a version
+
+Set `__version__` in `src/claudexer/__init__.py` (the single version source),
+commit the change, and push a matching tag. For the initial `0.1.0` release:
+
+```bash
+henv -n export_codex_session_dev -x git push origin main
+henv -n export_codex_session_dev -x git tag -a v0.1.0 -m 'Release 0.1.0'
+henv -n export_codex_session_dev -x git push origin v0.1.0
+```
+
+For later releases, change the version and tag together. Prereleases such as
+`0.2.0rc1` use `v0.2.0rc1`. PyPI versions are immutable: publish a new version
+for changed artifacts. If publishing fails before upload, fix the configuration
+and rerun the failed workflow jobs. If only GitHub release creation fails after
+PyPI succeeds, rerun that failed job rather than publishing again.
+
+See [PyPI's Trusted Publishing documentation](https://docs.pypi.org/trusted-publishers/)
+for account setup details. Ordinary pushes to `main` and pull requests run the
+same tests and packaging checks without publishing.
+
+## License
+
+MIT; see [LICENSE](LICENSE).

claudexer-0.4.0/README.md

@@ -0,0 +1,240 @@
+# Claudexer
+
+Browse local Codex and Claude Code sessions, resume one where you left off, or
+export it to readable **standalone HTML** or **Markdown**. Run `claudexer`
+without a filename to browse both providers in a full-screen Textual picker.
+Preview the first and last 10 user prompts before choosing a session.
+
+This project was previously published as `claudex-export`; see its
+[final release notes](https://pypi.org/project/claudex-export/) if you're
+migrating from that name.
+
+In the Textual picker, `Enter` resumes the selected session by exec'ing
+`claude --resume ID` or `codex resume ID` (whichever binary the session
+belongs to must be on `PATH`, and it runs from the session's original working
+directory when known). Press `e` to export instead; a modal reports the
+written file(s) or any error without leaving the picker.
+
+**Exports are sanitized by default.** They contain the session date, title,
+recorded elapsed time when available, direct user prompts, and assistant
+progress/final replies. Tools, execution plans, injected context, images,
+session IDs, working directories, and individual message timestamps are omitted.
+Use `--full` to restore the previous detailed transcript, or press `f` in the
+Textual picker or preview to toggle between sanitized and full export.
+
+Requires Python 3.10 or later. No API key or service is needed.
+
+## Install
+
+```bash
+python -m pip install claudexer
+```
+
+Or install it as an isolated command-line application with
+`pipx install claudexer`. Python and its dependencies are sufficient; `henv` is
+only used for development in this repository.
+
+## Usage
+
+```bash
+# Browse and search local sessions; HTML is the default
+claudexer
+
+# Browse only Claude Code sessions
+claudexer --source claude
+
+# Auto-detect a Claude Code file and export both formats
+claudexer /path/to/claude-session.jsonl --format both -o exports
+
+# Opt in to metadata, original messages, tool details, and images
+claudexer /path/to/session.jsonl --full -o detailed.html
+
+# Remove additional names or literal strings from sanitized output
+claudexer /path/to/session.jsonl --redact 'Jane Doe' --redact 'Acme Private Project'
+
+# Export a specified rollout
+claudexer /path/to/rollout.jsonl -o conversation.html
+
+# Markdown, without tool calls/results
+claudexer /path/to/rollout.jsonl --format md --no-tools -o conversation.md
+
+# Both formats, into a directory
+claudexer /path/to/rollout.jsonl --format both -o exports
+
+# Include archived sessions, or use another Codex home
+claudexer --include-archived
+claudexer --codex-home /path/to/.codex
+```
+
+The Textual picker supports arrow keys, Page Up/Down, and mouse navigation.
+Press `/` to focus live search; search matches titles, directories, IDs, and
+provider names. Enter in the search box returns focus to the results.
+
+| Key | Action |
+| --- | --- |
+| `↑` / `↓` | Move between sessions |
+| `Enter` on a session | Resume it: exec into `claude --resume ID` or `codex resume ID` |
+| `v` | Preview the selected session's user prompts |
+| `e` in list or preview | Export the selected/previewed session; a modal reports the result |
+| `f` in list or preview | Toggle sanitized/full export; current mode is displayed |
+| `Esc` / `v` in preview | Return to the list |
+| `/` | Focus search |
+| `Esc` in list | Clear search and focus the list |
+| `q` / `Ctrl+C` | Cancel |
+
+Previews are scrollable and loaded in a background worker. They follow the selected
+export mode and show prompt text with original numbering: the first 10 and last 10,
+without duplicates where those ranges overlap. For longer sessions a marker
+shows how many middle prompts were omitted. Tool results, injected context, and
+compaction summaries are excluded from the prompt preview. Images are counted,
+not opened. Reading a preview does not write an export.
+
+Use `--plain-picker` for the original numbered terminal picker (`/search`,
+`n`/`p`, number to select, `q` to cancel); prompt previews require the Textual
+picker. Without an interactive terminal, supply an explicit input file.
+
+By default, exports are written to the current directory with the date and a
+redacted title in the filename. Full exports use the original title and session
+ID. `-o` is a file path for a single format and a
+directory for `--format both`. Parent directories are created as needed.
+Existing files require `--force`; the source session is never overwritten.
+
+## Sanitization and full exports
+
+The same defaults apply to HTML and Markdown, including `--format both`.
+Sanitization removes recognizable email addresses, IP/MAC addresses, common
+phone-number formats, UUIDs, local paths, local hostnames, and known identity
+values from metadata and local account information. It also redacts those values
+in titles, prose, and code blocks. Links lose their destinations and image
+payloads are omitted. Generated filenames exclude the session ID and redact the
+title; an explicitly supplied `-o` name is used as given.
+
+This is deterministic, local, **best-effort** redaction. It cannot identify every
+person's name, street address, organization, or other identifying fact in arbitrary
+prose. Review a file before sharing it and supply repeatable `--redact TEXT`
+arguments for additional names or strings. No external service is used.
+
+Elapsed time is the span between recorded timestamps and includes idle time;
+it is omitted if the log does not provide distinct usable timestamps.
+
+`--full` disables sanitization and restores metadata, original conversation text,
+tools, images, and session event markers. `--no-tools` can still suppress tools
+in full mode. `--redact` applies only to sanitized mode. Full mode does not add
+raw system/developer instructions, reasoning, usage records, or unknown records
+that the parser has always excluded. The local picker still displays directories
+and IDs to help identify a session; they are not included in sanitized exports.
+
+## Supported content
+
+- Native Codex rollout and Claude Code `.jsonl` files, containing one JSON
+  record per line. File content determines the format automatically; use
+  `--source codex` or `--source claude` to specify it explicitly.
+- `.json` containing a single native session record or an array of records.
+  Codex records use `type`/`payload`; Claude Code uses `type`/`message` and
+  session metadata. Arbitrary chat JSON formats are not supported.
+- User messages and assistant progress/final replies in recorded order. Tool
+  inputs/results and compaction/interruption markers are included with `--full`.
+- Native transcript records take priority over matching completion events.
+  Duplicates are matched by IDs and by content within each turn, one occurrence
+  at a time. Separate repeated messages remain present.
+- System/developer messages, reasoning, usage records, and replacement history
+  from compaction are omitted. Instructions stored as actual **user** messages
+  remain part of the full transcript. Known injected context is omitted in
+  sanitized mode.
+- Tools invoked inside an orchestration tool may appear as separate execution
+  events as well as in that tool's output: these describe nested operations.
+- Claude Code tool-use blocks pair with tool results by tool-use ID. Replayed
+  UUIDs are deduplicated while separate blocks sharing a message ID survive.
+  Thinking blocks, metadata, and compacted summaries are omitted. End-of-turn
+  replies use the light blue final-answer styling.
+
+HTML includes responsive styling, highlighted code, tables, links, message
+anchors, collapsed tool details, expand/collapse buttons, and a print button.
+It uses embedded CSS/JavaScript and works offline. Printing expands tool details.
+Markdown keeps conversation formatting and uses fenced blocks for tool data.
+
+With `--full`, embedded PNG, JPEG, GIF, and WebP data images are preserved. Other image
+references become placeholders; the exporter does not fetch remote images or
+read image paths from the transcript. Raw HTML is escaped in conversation prose;
+HTML exports restrict scripts and resource loads with a Content Security Policy.
+
+Codex discovery respects `--codex-home`, then `CODEX_HOME`, then `~/.codex`.
+It scans `sessions/` (and optionally `archived_sessions/`) and uses
+`session_index.jsonl` titles when available. Sessions are sorted by recent
+activity. Each export covers one file; child/subagent sessions are not recursively
+included. Claude Code discovery respects `--claude-home`, then
+`CLAUDE_CONFIG_DIR`, then `~/.claude`, and reads main session files under
+`projects/`. Custom or automatic session titles take priority over the first
+prompt. Subagent logs are excluded from discovery; pass a subagent file explicitly
+to export it. `--source all` (the default) combines both providers; archived
+session inclusion applies to Codex. Source files and databases are never modified.
+
+Unknown record types and malformed JSONL lines produce warnings. An incomplete
+final line in a running session is skipped; rerun the export later to include it.
+Local session formats can evolve, so inspect export notes when a newer record type
+appears. Full exports contain the selected conversation and tool data as stored;
+sanitized exports apply the redaction described above.
+
+## Development
+
+```bash
+henv -n export_codex_session_dev -x python -m pip install -e '.[dev]'
+henv -n export_codex_session_dev -x python -m pytest
+```
+
+Tests use synthetic sessions, including headless Textual keyboard/preview tests.
+Keep private session files and generated exports
+out of source control; `exports/` is ignored for local previews.
+
+## Releases to PyPI
+
+Pushing a version tag triggers `.github/workflows/release.yml`. It runs tests
+on Python 3.10–3.14, builds an sdist and wheel, checks package metadata, and
+smoke-tests an installation of the built wheel. The tag must exactly match
+`v` followed by the package version. Only then does it publish to PyPI and
+create a GitHub release with both distribution files attached.
+
+### One-time PyPI setup
+
+In your PyPI account, open [Publishing](https://pypi.org/manage/account/publishing/)
+and add a **pending GitHub publisher** with these exact values:
+
+| Field | Value |
+| --- | --- |
+| PyPI project name | `claudexer` |
+| GitHub owner | `matplo` |
+| Repository | `claudexer` |
+| Workflow filename | `release.yml` |
+| Environment name | `pypi` |
+
+If the PyPI project already exists in your account, add the same publisher
+under that project's Publishing settings. The GitHub workflow uses OIDC
+Trusted Publishing; no `PYPI_API_TOKEN` secret is needed. The GitHub environment
+`pypi` must not require reviewer approval if you want fully automatic releases.
+The PyPI project is created by the first successful publish, not by registering
+the pending publisher.
+
+### Publish a version
+
+Set `__version__` in `src/claudexer/__init__.py` (the single version source),
+commit the change, and push a matching tag. For the initial `0.1.0` release:
+
+```bash
+henv -n export_codex_session_dev -x git push origin main
+henv -n export_codex_session_dev -x git tag -a v0.1.0 -m 'Release 0.1.0'
+henv -n export_codex_session_dev -x git push origin v0.1.0
+```
+
+For later releases, change the version and tag together. Prereleases such as
+`0.2.0rc1` use `v0.2.0rc1`. PyPI versions are immutable: publish a new version
+for changed artifacts. If publishing fails before upload, fix the configuration
+and rerun the failed workflow jobs. If only GitHub release creation fails after
+PyPI succeeds, rerun that failed job rather than publishing again.
+
+See [PyPI's Trusted Publishing documentation](https://docs.pypi.org/trusted-publishers/)
+for account setup details. Ordinary pushes to `main` and pull requests run the
+same tests and packaging checks without publishing.
+
+## License
+
+MIT; see [LICENSE](LICENSE).

claudexer-0.4.0/examples/claude-demo.jsonl

@@ -0,0 +1,5 @@
+{"type":"ai-title","sessionId":"claude-demo","aiTitle":"A portable session archive"}
+{"type":"user","uuid":"demo-u1","sessionId":"claude-demo","cwd":"/projects/session-exporter","timestamp":"2026-09-07T17:00:00Z","message":{"role":"user","content":"Can I export Claude Code conversations with the same pastel styling?"}}
+{"type":"assistant","uuid":"demo-a1","sessionId":"claude-demo","timestamp":"2026-09-07T17:00:02Z","message":{"role":"assistant","id":"demo-msg1","stop_reason":"tool_use","content":[{"type":"text","text":"I'll check the session format and reuse the existing renderers."},{"type":"tool_use","id":"demo-tool","name":"Bash","input":{"command":"python -m pytest -q"}}]}}
+{"type":"user","uuid":"demo-result","sessionId":"claude-demo","timestamp":"2026-09-07T17:00:03Z","message":{"role":"user","content":[{"type":"tool_result","tool_use_id":"demo-tool","content":"Tests passed."}]}}
+{"type":"assistant","uuid":"demo-a2","sessionId":"claude-demo","timestamp":"2026-09-07T17:00:06Z","message":{"role":"assistant","id":"demo-msg2","stop_reason":"end_turn","content":[{"type":"text","text":"Claude Code sessions now export to **HTML** and **Markdown**.\n\n```bash\nsession-export --source claude\n```\n\nIn the picker, press **v** to read the first and last 10 user prompts before selecting a session."}]}}

claudexer-0.4.0/examples/demo.jsonl

@@ -0,0 +1,6 @@
+{"timestamp":"2026-09-07T16:42:00Z","type":"session_meta","payload":{"id":"demo-session","title":"A small tool for keeping good conversations","timestamp":"2026-09-07T16:42:00Z","cwd":"/projects/session-exporter"}}
+{"timestamp":"2026-09-07T16:42:00Z","type":"response_item","payload":{"type":"message","role":"user","content":[{"type":"input_text","text":"Can we turn our session logs into something pleasant to read and easy to share? I'd like **HTML** for browsing and **Markdown** for my notes."}]}}
+{"timestamp":"2026-09-07T16:42:08Z","type":"response_item","payload":{"type":"message","role":"assistant","phase":"commentary","content":[{"type":"output_text","text":"I'll build a local exporter with a session picker. The HTML will work offline, and tool details will stay tucked away until you need them."}]}}
+{"timestamp":"2026-09-07T16:42:12Z","type":"response_item","payload":{"type":"function_call","name":"exec_command","call_id":"demo-call","arguments":"{\"cmd\": \"python -m pytest -q\", \"cwd\": \"/projects/session-exporter\"}"}}
+{"timestamp":"2026-09-07T16:42:13Z","type":"response_item","payload":{"type":"function_call_output","call_id":"demo-call","output":".............                                                            [100%]\n13 passed in 0.10s"}}
+{"timestamp":"2026-09-07T16:43:00Z","type":"response_item","payload":{"type":"message","role":"assistant","phase":"final_answer","content":[{"type":"output_text","text":"The exporter is ready. Start with a file, or leave the path out to choose from your local sessions.\n\n```bash\ncodex-export session.jsonl -o conversation.html\ncodex-export session.jsonl --format md -o notes.md\n```\n\n| Format | Good for | Tool details |\n| --- | --- | --- |\n| HTML | Reading, browsing, and printing | Collapsed by default |\n| Markdown | Notes, archives, and version control | Fenced text blocks |\n\n### Designed to travel\n\n- All styling is embedded in the HTML file.\n- Code, tables, and links keep their formatting.\n- Your original session stays untouched.\n\n> A useful export keeps the conversation readable and the technical details close at hand."}]}}

claudexer-0.4.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "claudexer"
+dynamic = ["version"]
+description = "Browse, resume, and export Codex and Claude Code sessions with a Textual picker"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "matplo"}]
+requires-python = ">=3.10"
+dependencies = ["markdown-it-py>=3,<5", "Pygments>=2.17,<3", "textual>=8.2,<9"]
+keywords = ["codex", "claude", "sessions", "markdown", "html", "textual", "resume"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/matplo/claudexer"
+Repository = "https://github.com/matplo/claudexer"
+Issues = "https://github.com/matplo/claudexer/issues"
+Changelog = "https://github.com/matplo/claudexer/releases"
+
+[project.optional-dependencies]
+dev = ["pytest>=8,<10"]
+
+[project.scripts]
+claudexer = "claudexer.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = {attr = "claudexer.__version__"}
+
+[tool.setuptools.package-data]
+claudexer = ["*.css", "*.js"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

claudexer-0.4.0/scripts/check_release.py

@@ -0,0 +1,20 @@
+"""Reject tags that do not match the installed distribution version."""
+
+from importlib.metadata import version
+import sys
+
+
+def check_tag(tag: str, package_version: str) -> None:
+    expected = f"v{package_version}"
+    if tag != expected:
+        raise ValueError(f"Tag {tag!r} does not match package version {package_version!r}; expected {expected!r}.")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        raise SystemExit("Usage: python scripts/check_release.py vX.Y.Z")
+    try:
+        check_tag(sys.argv[1], version("claudexer"))
+    except ValueError as exc:
+        raise SystemExit(str(exc)) from exc
+    print(f"Verified release tag {sys.argv[1]}")