claudex-export 0.1.0__tar.gz

claudex_export-0.1.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.

claudex_export-0.1.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

claudex_export-0.1.0/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: claudex-export
+Version: 0.1.0
+Summary: Export Codex and Claude Code sessions with a Textual browser and prompt previews
+Author: matplo
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/matplo/claudex-export
+Project-URL: Repository, https://github.com/matplo/claudex-export
+Project-URL: Issues, https://github.com/matplo/claudex-export/issues
+Project-URL: Changelog, https://github.com/matplo/claudex-export/releases
+Keywords: codex,claude,sessions,markdown,html,textual
+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<7,>=6.12
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Dynamic: license-file
+
+# Claudex Export
+
+Export local Codex and Claude Code conversations to readable **standalone HTML**
+or **Markdown**. Run `claudex-export`
+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.
+
+Requires Python 3.10 or later. No API key or service is needed.
+
+## Install
+
+```bash
+python -m pip install claudex-export
+```
+
+Or install it as an isolated command-line application with
+`pipx install claudex-export`. The commands `claudex-export`, `claude-export`,
+`codex-export`, and the compatibility alias `session-export` launch the same
+tool and support both providers. 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
+claudex-export
+
+# Browse only Claude Code sessions
+claudex-export --source claude
+
+# Auto-detect a Claude Code file and export both formats
+claudex-export /path/to/claude-session.jsonl --format both -o exports
+
+# Export a specified rollout
+claudex-export /path/to/rollout.jsonl -o conversation.html
+
+# Markdown, without tool calls/results
+claudex-export /path/to/rollout.jsonl --format md --no-tools -o conversation.md
+
+# Both formats, into a directory
+claudex-export /path/to/rollout.jsonl --format both -o exports
+
+# Include archived sessions, or use another Codex home
+claudex-export --include-archived
+claudex-export --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 | Select and export |
+| `v` | Preview the selected session's user prompts |
+| `Esc` / `v` in preview | Return to the list |
+| `e` in preview | Select and export the previewed session |
+| `/` | 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 show complete
+prompt text with original numbering and timestamps: 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 a sanitized title
+and session ID in the filename. `-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.
+
+## 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, assistant progress and final replies, tool inputs/results,
+  and markers for compaction/interruption, in recorded order.
+- 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 transcript.
+- 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.
+
+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. Exports contain the selected conversation and tool data as stored;
+there is no automatic secret redaction.
+
+## 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 | `claudex-export` |
+| GitHub owner | `matplo` |
+| Repository | `claudex-export` |
+| 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/codex_export/__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).

claudex_export-0.1.0/README.md

@@ -0,0 +1,191 @@
+# Claudex Export
+
+Export local Codex and Claude Code conversations to readable **standalone HTML**
+or **Markdown**. Run `claudex-export`
+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.
+
+Requires Python 3.10 or later. No API key or service is needed.
+
+## Install
+
+```bash
+python -m pip install claudex-export
+```
+
+Or install it as an isolated command-line application with
+`pipx install claudex-export`. The commands `claudex-export`, `claude-export`,
+`codex-export`, and the compatibility alias `session-export` launch the same
+tool and support both providers. 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
+claudex-export
+
+# Browse only Claude Code sessions
+claudex-export --source claude
+
+# Auto-detect a Claude Code file and export both formats
+claudex-export /path/to/claude-session.jsonl --format both -o exports
+
+# Export a specified rollout
+claudex-export /path/to/rollout.jsonl -o conversation.html
+
+# Markdown, without tool calls/results
+claudex-export /path/to/rollout.jsonl --format md --no-tools -o conversation.md
+
+# Both formats, into a directory
+claudex-export /path/to/rollout.jsonl --format both -o exports
+
+# Include archived sessions, or use another Codex home
+claudex-export --include-archived
+claudex-export --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 | Select and export |
+| `v` | Preview the selected session's user prompts |
+| `Esc` / `v` in preview | Return to the list |
+| `e` in preview | Select and export the previewed session |
+| `/` | 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 show complete
+prompt text with original numbering and timestamps: 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 a sanitized title
+and session ID in the filename. `-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.
+
+## 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, assistant progress and final replies, tool inputs/results,
+  and markers for compaction/interruption, in recorded order.
+- 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 transcript.
+- 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.
+
+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. Exports contain the selected conversation and tool data as stored;
+there is no automatic secret redaction.
+
+## 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 | `claudex-export` |
+| GitHub owner | `matplo` |
+| Repository | `claudex-export` |
+| 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/codex_export/__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).

claudex_export-0.1.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."}]}}

claudex_export-0.1.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."}]}}

claudex_export-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "claudex-export"
+dynamic = ["version"]
+description = "Export Codex and Claude Code sessions with a Textual browser and prompt previews"
+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>=6.12,<7"]
+keywords = ["codex", "claude", "sessions", "markdown", "html", "textual"]
+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/claudex-export"
+Repository = "https://github.com/matplo/claudex-export"
+Issues = "https://github.com/matplo/claudex-export/issues"
+Changelog = "https://github.com/matplo/claudex-export/releases"
+
+[project.optional-dependencies]
+dev = ["pytest>=8,<10"]
+
+[project.scripts]
+claudex-export = "codex_export.cli:main"
+claude-export = "codex_export.cli:main"
+codex-export = "codex_export.cli:main"
+session-export = "codex_export.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = {attr = "codex_export.__version__"}
+
+[tool.setuptools.package-data]
+codex_export = ["*.css", "*.js"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

claudex_export-0.1.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("claudex-export"))
+    except ValueError as exc:
+        raise SystemExit(str(exc)) from exc
+    print(f"Verified release tag {sys.argv[1]}")

claudex_export-0.1.0/scripts/smoke_install.py

@@ -0,0 +1,30 @@
+"""Run with python -I after installing a wheel, outside source imports."""
+
+from importlib.metadata import distribution
+from importlib.resources import files
+from pathlib import Path
+from tempfile import TemporaryDirectory
+
+from codex_export import __version__
+from codex_export.cli import main
+from codex_export.render import render_html, render_markdown
+from codex_export.session import Entry, Session
+from codex_export.tui import SessionPicker
+
+
+package = distribution("claudex-export")
+assert package.version == __version__
+assert {"claudex-export", "claude-export", "codex-export", "session-export"} <= {entry.name for entry in package.entry_points}
+assert files("codex_export").joinpath("style.css").is_file()
+assert files("codex_export").joinpath("controls.js").is_file()
+for provider in ("codex", "claude"):
+    session = Session(Path("smoke.jsonl"), title="Installed wheel smoke test", provider=provider,
+                      entries=[Entry("user", "Hello"), Entry("assistant", "Done", phase="final_answer")])
+    assert 'class="message assistant final"' in render_html(session)
+    assert "Hello" in render_markdown(session)
+assert SessionPicker([]).candidates == []
+with TemporaryDirectory() as directory:
+    source = Path(directory) / "session.jsonl"
+    source.write_text('{"type":"response_item","payload":{"type":"message","role":"user","content":[{"type":"input_text","text":"Smoke test"}]}}\n', encoding="utf-8")
+    assert main([str(source), "--format", "both", "-o", str(Path(directory) / "out")]) == 0
+print(f"Installed wheel {package.version}: entry points, renderers, TUI, and bundled assets OK")

claudex_export-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+