convoviz

Turn your ChatGPT export into Markdown notes and charts.
Read and search your whole chat history in Obsidian or any Markdown app. Runs on your computer.

_{Made from an invented export. Yours never leaves your computer.}

Quick start

1. In ChatGPT, open Settings → Data controls → Export data, and download the ZIP from the email.

2. Install convoviz:

# macOS / Linux
curl -LsSf https://raw.githubusercontent.com/mohamed-chs/convoviz/main/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/mohamed-chs/convoviz/main/install.ps1 | iex"

3. Run it:

convoviz

It finds the newest export in Downloads and writes your archive to Documents/ChatGPT Archive.

What you get

"n1": {
  "parent": "root",
  "message": {
    "author": {"role": "user"},
    "create_time": 1773480612.0,
    "content": {
      "content_type": "text",
      "parts": [
        "Three days in Kyoto in…"
      ]
    }
  }
},
"n2": {
  "parent": "n1",
  "message": {
    "author": {"role": "assistant"},
    "content": {
      "content_type": "thoughts",
      // … and on, for every message

---
created: 2026-03-14T09:30:12
models: ["gpt-5-5-thinking"]
tags: ["chatgpt"]
---

# Planning a trip to Kyoto

## You · 2026-03-14 09:30

Three days in Kyoto in April —
what should I not miss?

## ChatGPT · 2026-03-14 09:30

<details>
<summary>Thought for 8s</summary>…

- **Fushimi Inari** early, before
  the tour groups[^1].
…

• One Markdown note per conversation, sorted by year. See a full example.
• Sources as footnotes, reasoning and tool output folded, edited replies kept.
• Images, files and Canvas documents saved next to the notes.
• An index, and a sortable table of every conversation in Obsidian.
• insights.html: charts and word clouds of how you use ChatGPT, offline.

Updating

Run it again on a newer export. Only new and changed conversations are written. Notes you edited, moved or deleted stay as you left them (--force overrides that).

Options

convoviz ~/Downloads/chatgpt-export.zip -o ~/Notes/ChatGPT

convoviz config init creates a settings file for labels, tags, words to leave out of word clouds, and more.

FAQ

Something wrong?

Run convoviz inspect --json and paste the output into a bug report. It lists the export's structure only, never your conversations.

If convoviz helped you, a ⭐ helps others find it. To contribute, see CONTRIBUTING.md. MIT license.