Skip to content

Releases: voidfreud/chatgpt-export-tool

v1.0.0

27 Mar 22:53
fc1cbef

Choose a tag to compare

chatgpt-export v1.0.0

First stable release.

Highlights

  • Markdown-first — clean .md output with # headings, bold metadata, blockquoted context
  • Streaming — handles 100MB+ exports without loading them into memory
  • Flexible — three formats (md/txt/json), four split modes, structural + metadata filtering
  • Configurable — single TOML file for persistent defaults, CLI flags override everything

Features

  • analyze command — conversation count, message count, file size, date range, field coverage
  • export command — Markdown, plain text, or JSON with composable filtering
  • Structural field filtering (--fields) with include/exclude/groups
  • Metadata filtering (--include/--exclude) with glob patterns
  • Split modes: single, subject, date, ID
  • Transcript-oriented export following the active conversation branch
  • ChatGPT artifact and horizontal rule stripping in Markdown mode
  • UTC timestamps with configurable date formats
  • TOML configuration with semantic validation
  • 217 tests, CI on Python 3.10–3.13

Install

git clone https://github.com/voidfreud/chatgpt-export-tool.git
cd chatgpt-export-tool
uv sync
uv run chatgpt-export --help