jatechan / ai-data-extractor

# AI Coding Assistant Data Extraction 
Extract your **own local chat history** from AI coding assistants into a single,
normalized JSONL format - for fine-tuning, personal analytics, or just backing
up years of conversations before an app's local database gets cleared.
## Features
Auto-discovers and extracts complete conversation history, including:
- User messages & assistant responses
- Code context (file paths, selections, snippets)
- Code diffs / suggested edits, where the tool records them
- Tool calls and their results
- Timestamps, session IDs, project paths, model names - whatever each
 tool's storage actually contains
## Supported sources
| # | Tool | Storage | Search location |
|---|------|---------|------------------|
| 1 | **Claude Code** | JSONL, one file per session | `~/.claude/projects/**/*.jsonl` |
| 2 | **Codex CLI** | JSONL "rollout" files | `~/.codex/sessions/**/rollout-*.jsonl` |
| 3 | **Cursor** | SQLite (`state.vscdb`) | `~/…/Cursor/User/{global,workspace}Storage` |
| 4 | **Windsurf** | SQLite, undocumented schema (heuristic) | `~/…/Windsurf/User/{global,workspace}Storage` |
| 5 | **Trae** | SQLite + JSONL, undocumented (heuristic) | `~/…/Trae` |
| 6 | **Continue** | JSON, one file per session | `~/.continue/sessions/*.json` |
| 7 | **Gemini CLI** | JSON, one file per chat | `~/.gemini/tmp/ /chats/*.json` |
| 8 | **OpenCode** | JSON (session/message/part trees) | `~/.local/share/opencode/storage/` |
| 9 | **Cline / Roo Code** *(new)* | JSON, one folder per task | ` /User/globalStorage/ /tasks/` |
| 10 | **Aider** *(new)* | Markdown transcript per project | ` /.aider.chat.history.md` |
Every script searches macOS, Linux, and Windows conventions
(`~/Library/Application Support`, `~/.config`, `~/.local/share`, `%APPDATA%`,
`%LOCALAPPDATA%`) automatically - you don't need to tell it which OS you're on.
### Why Cline and Aider
They're two of the most-used AI coding tools that the original list left out,
and both have a genuinely different (and instructive) storage shape:
- **Cline** (and its fork **Roo Code**) is the most popular open-source
 autonomous coding *agent* extension. It stores raw Anthropic-format
 message arrays per task, so its extractor doubles as the simplest example
 of parsing that format if you want to add your own tool later.
- **Aider** is the most popular *terminal-only* pair-programming tool, and
 it's structured completely differently from everything else here: no
 central database, just a markdown transcript sitting in every project
 directory. It's included specifically to prove the toolkit generalizes
 beyond "SQLite or JSONL in one app-data folder."
## Quick start
 [code] 
### CLI reference
 [code] 
Each extractor can also still be run standalone, same as the original
toolkit (`python -m extractors.cursor` from the project root, or
`python extractors/cursor.py`), which is handy while debugging one source.
## Output format
Every run creates timestamped fi