— A lightweight, offline converter for ChatGPT HTML exports → clean Markdown or JSONL. Private, portable, precise — a tool for reclaiming your words from the void.

Memory deserves structure.

EchoForge transforms ChatGPT’s "Save Page As..." HTML into durable, human-readable artifacts:

• Markdown for notes, vaults, and documents
• JSONL for datasets, training corpora, and analysis
• Works under Windows/Linux/macOS

No APIs.
No servers.
No cloud.
Just your conversations, reforged exactly how you want them.

• HTML purification — removes scripts, UI clutter, hidden markup
• Speaker separation — labels user vs assistant turns
• Code block preservation — intact fenced Markdown
• Pretty Mode — structured, numbered, formatted
• Themes — light, dark, auto, obsidian
• Obsidian link rewriting
• JSONL export
• Emoji + symbol integrity
• Signature mode — optional footer mark

git clone https://github.com/noct-ml/echo-forge.git
cd echo-forge
chmod +x echoforge.py

python echoforge.py chat.html out.md

python echoforge.py chat.html conversation.md --by-speaker --user-label "James" --pretty-md --theme obsidian --obsidian-links

python echoforge.py chat.html chat.jsonl --by-speaker --jsonl

# Dream Dialogue: Coil vs World
### Turn 001 — James
John Balance understood.
### Turn 002 — ChatGPT
In Love’s Secret Domain!
---
> Forged by EchoForge v1.1.7 — "Forging echoes into clarity." 🜏

1. HTML Parser — cleans + extracts
2. Speaker Labeler — identifies turns
3. Renderer — builds Markdown
4. Exporter — writes Markdown/JSONL
5. Link Rewriter — Obsidian-safe anchors

Fast, minimal, future-proof.

Your conversations are artifacts, not exhaust.
Your words belong to you.
Memory should be shaped, not scattered.