netcodex-agent-exporter 0.3.0__tar.gz → 0.3.2__tar.gz

{netcodex_agent_exporter-0.3.0 → netcodex_agent_exporter-0.3.2}/.gitignore

@@ -30,3 +30,6 @@ docs/architecture/generated/
 # PyInstaller
 *.spec
 binaries/
+
+# Built export desk (generated by npm run desk:build, shipped in the wheel)
+src/netcodex/web/desk/

{netcodex_agent_exporter-0.3.0 → netcodex_agent_exporter-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: netcodex-agent-exporter
-Version: 0.3.0
+Version: 0.3.2
 Summary: Local-first exporter for AI agent conversations (Codex, Claude Code, Copilot, Cline, Cursor, Gemini CLI and more) to Markdown.
 Project-URL: Homepage, https://gitlab.com/netcodex-tech/agent-conversation-exporter
 Project-URL: Repository, https://gitlab.com/netcodex-tech/agent-conversation-exporter
@@ -41,24 +41,44 @@ and Codex into Markdown, Quarkdown and PDF.
 
 ## Status
 
-Version 0.2 ("correct exports"). Supported sources:
-
-| Source | Where it is read from | Client labels (`tool`) |
-| --- | --- | --- |
-| Codex CLI / VS Code extension / Codex Desktop | `$CODEX_HOME` or `~/.codex`: newest `state_*.sqlite` (`threads`, `thread_spawn_edges`), `session_index.jsonl` titles, rollout JSONL in `sessions/` and `archived_sessions/` | `codex-cli`, `codex-vscode`, `codex-desktop` |
-| Claude Code CLI / VS Code | `$CLAUDE_CONFIG_DIR/projects` or `~/.claude/projects/**/<session>.jsonl`; subagents in `<session>/subagents/agent-*.jsonl` are grouped under their parent | `claude-code-cli`, `claude-code-vscode` |
-| Claude desktop "Code" tab | Same JSONL, titled from `%APPDATA%/Claude/claude-code-sessions/**/local_*.json` | `claude-desktop` |
-| Claude desktop Cowork | `%APPDATA%/Claude/local-agent-mode-sessions/**/local_<id>.json` + `local_<id>/.claude/projects/**/*.jsonl` | `claude-cowork` |
-| GitHub Copilot Chat (`copilot-chat`) | `<editor>/User/workspaceStorage/*/chatSessions/*.jsonl` (operation log) or `.json`, `globalStorage/emptyWindowChatSessions` in every VS Code-family editor | `copilot-chat-<editor>` |
-| Cline / Roo Code / Kilo Code (`cline`) | `<editor>/User/globalStorage/<extension>/tasks/<id>/api_conversation_history.json` | `cline-*`, `roo-code-*`, `kilo-code-*` |
-| Cursor (`cursor`) | `Cursor/User/globalStorage/state.vscdb` (`cursorDiskKV` composer + bubbles) | `cursor` |
-| GitHub Copilot CLI (`copilot-cli`) | `~/.copilot/session-state/<id>/events.jsonl` | `copilot-cli` |
-| Gemini CLI (`gemini-cli`) | `~/.gemini/tmp/<hash>/chats/session-*.json`, `logs.json` | `gemini-cli` |
-| Continue (`continue`) | `~/.continue/sessions/*.json` | `continue` |
-| Aider (`aider`) | `.aider.chat.history.md` in repos under `NETCODEX_AIDER_PATHS` or the home folder (depth 3) | `aider` |
-| claude.ai chats (`claude-ai`) | Official export ZIP / `conversations.json` from `NETCODEX_CLAUDE_AI_EXPORT` or `~/Downloads` | `claude-ai` |
-| Google Antigravity (`antigravity`) | `~/.gemini/antigravity/conversation_summaries.db` + `conversations/*.db` (schemaless protobuf, best effort; legacy encrypted `.pb` skipped) | `antigravity` |
-| Trae, Windsurf (`trae`, `windsurf`) | Encrypted stores: reported by `netcodex sources`, not exported | - |
+Version 0.3. Supported tools, where each one keeps its chats, and how to import them
+(`netcodex where` prints the same table with the paths that exist on your machine).
+
+### Where are my chats?
+
+<!-- netcodex:where:start (generated by scripts/export_locations.py) -->
+| Tool | Status | Windows | macOS / Linux | Import via |
+| --- | --- | --- | --- | --- |
+| Codex CLI / VS Code / Desktop | supported; override: `CODEX_HOME` | `%USERPROFILE%\.codex\sessions\YYYY\MM\DD\rollout-*.jsonl`<br>`%USERPROFILE%\.codex\archived_sessions\rollout-*.jsonl`<br>`%USERPROFILE%\.codex\state_*.sqlite`<br>`%USERPROFILE%\.codex\session_index.jsonl` | `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl`<br>`~/.codex/archived_sessions/rollout-*.jsonl`<br>`~/.codex/state_*.sqlite`<br>`~/.codex/session_index.jsonl` | Upload files, Local sources, CLI |
+| Claude Code CLI / VS Code | supported; override: `CLAUDE_CONFIG_DIR` | `%USERPROFILE%\.claude\projects\<project>\<session>.jsonl` | `~/.claude/projects/<project>/<session>.jsonl` | Upload files, Local sources, CLI |
+| Claude Desktop (Code tab) | supported; override: `CLAUDE_CONFIG_DIR` | `%APPDATA%\Claude\claude-code-sessions\**\local_*.json`<br>`%USERPROFILE%\.claude\projects\<project>\<session>.jsonl` | `<config>/Claude/claude-code-sessions/**/local_*.json`<br>`~/.claude/projects/<project>/<session>.jsonl` | Local sources, CLI |
+| Claude Cowork | supported | `%APPDATA%\Claude\local-agent-mode-sessions\**\local_<id>.json`<br>`%APPDATA%\Claude\local-agent-mode-sessions\**\local_<id>\.claude\projects\**\*.jsonl` | `<config>/Claude/local-agent-mode-sessions/**/local_<id>.json`<br>`<config>/Claude/local-agent-mode-sessions/**/local_<id>/.claude/projects/**/*.jsonl` | Local sources, CLI |
+| Claude.ai (official data export) | supported; override: `NETCODEX_CLAUDE_AI_EXPORT` | `%USERPROFILE%\Downloads\data-*.zip`<br>`%USERPROFILE%\Downloads\<folder>\conversations.json` | `~/Downloads/data-*.zip`<br>`~/Downloads/<folder>/conversations.json` | Local sources, CLI |
+| GitHub Copilot Chat | supported | `%APPDATA%\<editor>\User\workspaceStorage\<hash>\chatSessions\*.jsonl`<br>`%APPDATA%\<editor>\User\workspaceStorage\<hash>\chatSessions\*.json`<br>`%APPDATA%\<editor>\User\globalStorage\emptyWindowChatSessions\*.json` | `<config>/<editor>/User/workspaceStorage/<hash>/chatSessions/*.jsonl`<br>`<config>/<editor>/User/workspaceStorage/<hash>/chatSessions/*.json`<br>`<config>/<editor>/User/globalStorage/emptyWindowChatSessions/*.json` | Local sources, CLI |
+| GitHub Copilot CLI | supported | `%USERPROFILE%\.copilot\session-state\<id>\events.jsonl` | `~/.copilot/session-state/<id>/events.jsonl` | Local sources, CLI |
+| Cline / Roo Code / Kilo Code | supported | `%APPDATA%\<editor>\User\globalStorage\saoudrizwan.claude-dev\tasks\<id>\api_conversation_history.json`<br>`%APPDATA%\<editor>\User\globalStorage\rooveterinaryinc.roo-cline\tasks\<id>\api_conversation_history.json`<br>`%APPDATA%\<editor>\User\globalStorage\kilocode.kilo-code\tasks\<id>\api_conversation_history.json` | `<config>/<editor>/User/globalStorage/saoudrizwan.claude-dev/tasks/<id>/api_conversation_history.json`<br>`<config>/<editor>/User/globalStorage/rooveterinaryinc.roo-cline/tasks/<id>/api_conversation_history.json`<br>`<config>/<editor>/User/globalStorage/kilocode.kilo-code/tasks/<id>/api_conversation_history.json` | Local sources, CLI |
+| Cursor | supported | `%APPDATA%\Cursor\User\globalStorage\state.vscdb` | `<config>/Cursor/User/globalStorage/state.vscdb` | Local sources, CLI |
+| Gemini CLI | supported | `%USERPROFILE%\.gemini\tmp\<hash>\chats\session-*.json`<br>`%USERPROFILE%\.gemini\tmp\<hash>\logs.json` | `~/.gemini/tmp/<hash>/chats/session-*.json`<br>`~/.gemini/tmp/<hash>/logs.json` | Local sources, CLI |
+| Continue | supported | `%USERPROFILE%\.continue\sessions\*.json` | `~/.continue/sessions/*.json` | Local sources, CLI |
+| Aider | supported; override: `NETCODEX_AIDER_PATHS` | `<repo>\.aider.chat.history.md` | `<repo>/.aider.chat.history.md` | Local sources, CLI |
+| Google Antigravity | best effort | `%USERPROFILE%\.gemini\antigravity\conversation_summaries.db`<br>`%USERPROFILE%\.gemini\antigravity\conversations\*.db` | `~/.gemini/antigravity/conversation_summaries.db`<br>`~/.gemini/antigravity/conversations/*.db` | Local sources, CLI |
+| Trae | encrypted, not supported | `%APPDATA%\Trae\ModularData\ai-agent\database.db`<br>`%APPDATA%\Trae CN\ModularData\ai-agent\database.db` | `<config>/Trae/ModularData/ai-agent/database.db`<br>`<config>/Trae CN/ModularData/ai-agent/database.db` | - |
+| Windsurf | encrypted, not supported | `%USERPROFILE%\.codeium\windsurf\cascade\*.pb` | `~/.codeium/windsurf/cascade/*.pb` | - |
+
+`<config>` is `~/Library/Application Support` on macOS and `~/.config` on Linux. `<editor>` is any VS Code-family editor: Code, Code - Insiders, VSCodium, Cursor, Windsurf, Trae, Trae CN, Antigravity, Kiro, Positron.
+<!-- netcodex:where:end -->
+
+Find them on your machine with `netcodex where` (`--json`, `--patterns`), or open the desk
+(`netcodex ui`) and click **Where are my chats?**: it lists every tool with its status, the
+resolved folder on this computer (Copy path / Open folder) and what to import. Encrypted
+stores (current Trae, Windsurf) are reported but cannot be exported. claude.ai chats are not
+stored locally: request the official data export (Settings > Privacy > Export data) and save
+the `data-*.zip` / `conversations.json` in Downloads or point `NETCODEX_CLAUDE_AI_EXPORT` at it.
+
+Client labels written to the `tool` field: `codex-cli`, `codex-vscode`, `codex-desktop`,
+`claude-code-cli`, `claude-code-vscode`, `claude-desktop`, `claude-cowork`,
+`copilot-chat-<editor>`, `cline-*`, `roo-code-*`, `kilo-code-*`, `cursor`, `copilot-cli`,
+`gemini-cli`, `continue`, `aider`, `claude-ai`, `antigravity`.
 
 All parsers map to one canonical model (`Conversation` -> `Turn` -> `MessagePart`
 with `text`, `tool_call`, `tool_result`, `reasoning`, `image`, `attachment`,
@@ -86,19 +106,33 @@ v0.3.0). Extras: `[ui]` (alias `[web]`) adds FastAPI/uvicorn for `netcodex ui` a
 upload API; the core CLI only needs Pydantic and Typer. PDF export needs the external
 [Quarkdown](https://github.com/iamgio/quarkdown) binary on `PATH` (no Python extra).
 
-### Local UI
+### Local UI: the Conversation export desk
 
 ```powershell
-netcodex ui            # opens http://127.0.0.1:<port>/#token=... in your browser
+netcodex ui            # opens http://127.0.0.1:<port>/app/#token=... in your browser
 netcodex ui --port 8765 --out D:\exports --no-open
+netcodex --version
 ```
 
-The UI lists every detected source and its conversations, previews the Markdown
-(reasoning / tool output / system context toggles) and exports the selected or all
-conversations to a folder you choose, incrementally. It binds to 127.0.0.1 only;
-`--host` with a non-loopback address is refused unless `--allow-remote` is given.
-Every API call needs the per-launch token from the URL, and requests whose `Host` is
-not a loopback name are rejected.
+`netcodex ui` serves the full export desk from your own machine: an upload rail for
+JSONL/SQLite/ZIP files with source auto-detection, a **Local sources** tab that reads the
+detected tools directly (Codex, Claude Code, Copilot, Cline, Cursor, Gemini CLI, ...),
+MD/QD/PDF formats with Quarkdown templates, the Upload > Analyze > Review > Export > Done
+tracker, a system activity log, the preview and the export summary with the ZIP download.
+The preview shows the Quarkdown HTML for QD/PDF exports and a rendered (sanitized) Markdown
+view for Markdown-only exports, plus the Markdown source tab. **Where are my chats?** (header
+button and Upload rail link) lists every supported tool with its status, the folder found on
+this computer (Copy path / Open folder) and what to import. QD and PDF need the Quarkdown CLI;
+the desk says so when it is missing.
+
+Everything runs on 127.0.0.1: `--host` with a non-loopback address is refused unless
+`--allow-remote` is given, API calls need the per-launch token from the URL (exchanged
+for an HttpOnly, SameSite=Strict session cookie), and requests whose `Host` is not a
+loopback name are rejected. Nothing is sent to a NetCodex server.
+
+The desk is the Next.js app in `web/`, built as a static site by `npm run desk:build`
+(`scripts/build-desk.mjs`) into `src/netcodex/web/desk/` and shipped in the wheel. A
+source checkout without that build falls back to a minimal built-in page.
 
 ## License
 
@@ -115,6 +149,8 @@ uv run netcodex --help
 
 ```powershell
 uv run netcodex sources                      # registered sources, found / not found
+uv run netcodex where                        # where each tool keeps its chats, and what is on this machine
+uv run netcodex where --json                 # same, machine-readable (also: sources --paths)
 uv run netcodex scan --sources all
 uv run netcodex analyze --source auto --json
 uv run netcodex export --all --out exports   # every available source, every session
@@ -145,6 +181,11 @@ uv run netcodex watch --out exports --interval 60   # Ctrl+C to stop
 
 Large exports use worker processes (`--jobs`, default automatic, up to 4).
 
+The "Where are my chats?" table above, `netcodex where`, the desk help panel and the public
+`/where` page all come from `netcodex.sources.locations`. After changing it, regenerate the
+README table and `web/lib/chat-locations.json` with `uv run python scripts/export_locations.py`
+(a test fails while they are out of date).
+
 Sources live in a registry (`netcodex.sources.registry`). Store locations come
 from a per-platform path matrix (`netcodex.sources.paths`: Windows
 `%APPDATA%`, macOS `~/Library/Application Support`, Linux `~/.config`) that also
@@ -225,8 +266,8 @@ npm run api:dev
 npm run web:dev
 ```
 
-The web UI reads `NEXT_PUBLIC_API_URL`; when it is not set, it uses
-`http://localhost:8000`. The MVP web flow accepts `.jsonl`, `.sqlite`, and
+In development (`npm run dev`) the desk reads `NEXT_PUBLIC_API_URL` (default
+`http://localhost:8000`) and the dev API also serves the local-sources endpoints. The MVP web flow accepts `.jsonl`, `.sqlite`, and
 `.zip` uploads, analyzes detected Claude/Codex sessions, previews Markdown,
 and downloads generated artifacts plus `netcodex-manifest.json` as a ZIP.
 

{netcodex_agent_exporter-0.3.0 → netcodex_agent_exporter-0.3.2}/README.md

@@ -5,24 +5,44 @@ and Codex into Markdown, Quarkdown and PDF.
 
 ## Status
 
-Version 0.2 ("correct exports"). Supported sources:
-
-| Source | Where it is read from | Client labels (`tool`) |
-| --- | --- | --- |
-| Codex CLI / VS Code extension / Codex Desktop | `$CODEX_HOME` or `~/.codex`: newest `state_*.sqlite` (`threads`, `thread_spawn_edges`), `session_index.jsonl` titles, rollout JSONL in `sessions/` and `archived_sessions/` | `codex-cli`, `codex-vscode`, `codex-desktop` |
-| Claude Code CLI / VS Code | `$CLAUDE_CONFIG_DIR/projects` or `~/.claude/projects/**/<session>.jsonl`; subagents in `<session>/subagents/agent-*.jsonl` are grouped under their parent | `claude-code-cli`, `claude-code-vscode` |
-| Claude desktop "Code" tab | Same JSONL, titled from `%APPDATA%/Claude/claude-code-sessions/**/local_*.json` | `claude-desktop` |
-| Claude desktop Cowork | `%APPDATA%/Claude/local-agent-mode-sessions/**/local_<id>.json` + `local_<id>/.claude/projects/**/*.jsonl` | `claude-cowork` |
-| GitHub Copilot Chat (`copilot-chat`) | `<editor>/User/workspaceStorage/*/chatSessions/*.jsonl` (operation log) or `.json`, `globalStorage/emptyWindowChatSessions` in every VS Code-family editor | `copilot-chat-<editor>` |
-| Cline / Roo Code / Kilo Code (`cline`) | `<editor>/User/globalStorage/<extension>/tasks/<id>/api_conversation_history.json` | `cline-*`, `roo-code-*`, `kilo-code-*` |
-| Cursor (`cursor`) | `Cursor/User/globalStorage/state.vscdb` (`cursorDiskKV` composer + bubbles) | `cursor` |
-| GitHub Copilot CLI (`copilot-cli`) | `~/.copilot/session-state/<id>/events.jsonl` | `copilot-cli` |
-| Gemini CLI (`gemini-cli`) | `~/.gemini/tmp/<hash>/chats/session-*.json`, `logs.json` | `gemini-cli` |
-| Continue (`continue`) | `~/.continue/sessions/*.json` | `continue` |
-| Aider (`aider`) | `.aider.chat.history.md` in repos under `NETCODEX_AIDER_PATHS` or the home folder (depth 3) | `aider` |
-| claude.ai chats (`claude-ai`) | Official export ZIP / `conversations.json` from `NETCODEX_CLAUDE_AI_EXPORT` or `~/Downloads` | `claude-ai` |
-| Google Antigravity (`antigravity`) | `~/.gemini/antigravity/conversation_summaries.db` + `conversations/*.db` (schemaless protobuf, best effort; legacy encrypted `.pb` skipped) | `antigravity` |
-| Trae, Windsurf (`trae`, `windsurf`) | Encrypted stores: reported by `netcodex sources`, not exported | - |
+Version 0.3. Supported tools, where each one keeps its chats, and how to import them
+(`netcodex where` prints the same table with the paths that exist on your machine).
+
+### Where are my chats?
+
+<!-- netcodex:where:start (generated by scripts/export_locations.py) -->
+| Tool | Status | Windows | macOS / Linux | Import via |
+| --- | --- | --- | --- | --- |
+| Codex CLI / VS Code / Desktop | supported; override: `CODEX_HOME` | `%USERPROFILE%\.codex\sessions\YYYY\MM\DD\rollout-*.jsonl`<br>`%USERPROFILE%\.codex\archived_sessions\rollout-*.jsonl`<br>`%USERPROFILE%\.codex\state_*.sqlite`<br>`%USERPROFILE%\.codex\session_index.jsonl` | `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl`<br>`~/.codex/archived_sessions/rollout-*.jsonl`<br>`~/.codex/state_*.sqlite`<br>`~/.codex/session_index.jsonl` | Upload files, Local sources, CLI |
+| Claude Code CLI / VS Code | supported; override: `CLAUDE_CONFIG_DIR` | `%USERPROFILE%\.claude\projects\<project>\<session>.jsonl` | `~/.claude/projects/<project>/<session>.jsonl` | Upload files, Local sources, CLI |
+| Claude Desktop (Code tab) | supported; override: `CLAUDE_CONFIG_DIR` | `%APPDATA%\Claude\claude-code-sessions\**\local_*.json`<br>`%USERPROFILE%\.claude\projects\<project>\<session>.jsonl` | `<config>/Claude/claude-code-sessions/**/local_*.json`<br>`~/.claude/projects/<project>/<session>.jsonl` | Local sources, CLI |
+| Claude Cowork | supported | `%APPDATA%\Claude\local-agent-mode-sessions\**\local_<id>.json`<br>`%APPDATA%\Claude\local-agent-mode-sessions\**\local_<id>\.claude\projects\**\*.jsonl` | `<config>/Claude/local-agent-mode-sessions/**/local_<id>.json`<br>`<config>/Claude/local-agent-mode-sessions/**/local_<id>/.claude/projects/**/*.jsonl` | Local sources, CLI |
+| Claude.ai (official data export) | supported; override: `NETCODEX_CLAUDE_AI_EXPORT` | `%USERPROFILE%\Downloads\data-*.zip`<br>`%USERPROFILE%\Downloads\<folder>\conversations.json` | `~/Downloads/data-*.zip`<br>`~/Downloads/<folder>/conversations.json` | Local sources, CLI |
+| GitHub Copilot Chat | supported | `%APPDATA%\<editor>\User\workspaceStorage\<hash>\chatSessions\*.jsonl`<br>`%APPDATA%\<editor>\User\workspaceStorage\<hash>\chatSessions\*.json`<br>`%APPDATA%\<editor>\User\globalStorage\emptyWindowChatSessions\*.json` | `<config>/<editor>/User/workspaceStorage/<hash>/chatSessions/*.jsonl`<br>`<config>/<editor>/User/workspaceStorage/<hash>/chatSessions/*.json`<br>`<config>/<editor>/User/globalStorage/emptyWindowChatSessions/*.json` | Local sources, CLI |
+| GitHub Copilot CLI | supported | `%USERPROFILE%\.copilot\session-state\<id>\events.jsonl` | `~/.copilot/session-state/<id>/events.jsonl` | Local sources, CLI |
+| Cline / Roo Code / Kilo Code | supported | `%APPDATA%\<editor>\User\globalStorage\saoudrizwan.claude-dev\tasks\<id>\api_conversation_history.json`<br>`%APPDATA%\<editor>\User\globalStorage\rooveterinaryinc.roo-cline\tasks\<id>\api_conversation_history.json`<br>`%APPDATA%\<editor>\User\globalStorage\kilocode.kilo-code\tasks\<id>\api_conversation_history.json` | `<config>/<editor>/User/globalStorage/saoudrizwan.claude-dev/tasks/<id>/api_conversation_history.json`<br>`<config>/<editor>/User/globalStorage/rooveterinaryinc.roo-cline/tasks/<id>/api_conversation_history.json`<br>`<config>/<editor>/User/globalStorage/kilocode.kilo-code/tasks/<id>/api_conversation_history.json` | Local sources, CLI |
+| Cursor | supported | `%APPDATA%\Cursor\User\globalStorage\state.vscdb` | `<config>/Cursor/User/globalStorage/state.vscdb` | Local sources, CLI |
+| Gemini CLI | supported | `%USERPROFILE%\.gemini\tmp\<hash>\chats\session-*.json`<br>`%USERPROFILE%\.gemini\tmp\<hash>\logs.json` | `~/.gemini/tmp/<hash>/chats/session-*.json`<br>`~/.gemini/tmp/<hash>/logs.json` | Local sources, CLI |
+| Continue | supported | `%USERPROFILE%\.continue\sessions\*.json` | `~/.continue/sessions/*.json` | Local sources, CLI |
+| Aider | supported; override: `NETCODEX_AIDER_PATHS` | `<repo>\.aider.chat.history.md` | `<repo>/.aider.chat.history.md` | Local sources, CLI |
+| Google Antigravity | best effort | `%USERPROFILE%\.gemini\antigravity\conversation_summaries.db`<br>`%USERPROFILE%\.gemini\antigravity\conversations\*.db` | `~/.gemini/antigravity/conversation_summaries.db`<br>`~/.gemini/antigravity/conversations/*.db` | Local sources, CLI |
+| Trae | encrypted, not supported | `%APPDATA%\Trae\ModularData\ai-agent\database.db`<br>`%APPDATA%\Trae CN\ModularData\ai-agent\database.db` | `<config>/Trae/ModularData/ai-agent/database.db`<br>`<config>/Trae CN/ModularData/ai-agent/database.db` | - |
+| Windsurf | encrypted, not supported | `%USERPROFILE%\.codeium\windsurf\cascade\*.pb` | `~/.codeium/windsurf/cascade/*.pb` | - |
+
+`<config>` is `~/Library/Application Support` on macOS and `~/.config` on Linux. `<editor>` is any VS Code-family editor: Code, Code - Insiders, VSCodium, Cursor, Windsurf, Trae, Trae CN, Antigravity, Kiro, Positron.
+<!-- netcodex:where:end -->
+
+Find them on your machine with `netcodex where` (`--json`, `--patterns`), or open the desk
+(`netcodex ui`) and click **Where are my chats?**: it lists every tool with its status, the
+resolved folder on this computer (Copy path / Open folder) and what to import. Encrypted
+stores (current Trae, Windsurf) are reported but cannot be exported. claude.ai chats are not
+stored locally: request the official data export (Settings > Privacy > Export data) and save
+the `data-*.zip` / `conversations.json` in Downloads or point `NETCODEX_CLAUDE_AI_EXPORT` at it.
+
+Client labels written to the `tool` field: `codex-cli`, `codex-vscode`, `codex-desktop`,
+`claude-code-cli`, `claude-code-vscode`, `claude-desktop`, `claude-cowork`,
+`copilot-chat-<editor>`, `cline-*`, `roo-code-*`, `kilo-code-*`, `cursor`, `copilot-cli`,
+`gemini-cli`, `continue`, `aider`, `claude-ai`, `antigravity`.
 
 All parsers map to one canonical model (`Conversation` -> `Turn` -> `MessagePart`
 with `text`, `tool_call`, `tool_result`, `reasoning`, `image`, `attachment`,
@@ -50,19 +70,33 @@ v0.3.0). Extras: `[ui]` (alias `[web]`) adds FastAPI/uvicorn for `netcodex ui` a
 upload API; the core CLI only needs Pydantic and Typer. PDF export needs the external
 [Quarkdown](https://github.com/iamgio/quarkdown) binary on `PATH` (no Python extra).
 
-### Local UI
+### Local UI: the Conversation export desk
 
 ```powershell
-netcodex ui            # opens http://127.0.0.1:<port>/#token=... in your browser
+netcodex ui            # opens http://127.0.0.1:<port>/app/#token=... in your browser
 netcodex ui --port 8765 --out D:\exports --no-open
+netcodex --version
 ```
 
-The UI lists every detected source and its conversations, previews the Markdown
-(reasoning / tool output / system context toggles) and exports the selected or all
-conversations to a folder you choose, incrementally. It binds to 127.0.0.1 only;
-`--host` with a non-loopback address is refused unless `--allow-remote` is given.
-Every API call needs the per-launch token from the URL, and requests whose `Host` is
-not a loopback name are rejected.
+`netcodex ui` serves the full export desk from your own machine: an upload rail for
+JSONL/SQLite/ZIP files with source auto-detection, a **Local sources** tab that reads the
+detected tools directly (Codex, Claude Code, Copilot, Cline, Cursor, Gemini CLI, ...),
+MD/QD/PDF formats with Quarkdown templates, the Upload > Analyze > Review > Export > Done
+tracker, a system activity log, the preview and the export summary with the ZIP download.
+The preview shows the Quarkdown HTML for QD/PDF exports and a rendered (sanitized) Markdown
+view for Markdown-only exports, plus the Markdown source tab. **Where are my chats?** (header
+button and Upload rail link) lists every supported tool with its status, the folder found on
+this computer (Copy path / Open folder) and what to import. QD and PDF need the Quarkdown CLI;
+the desk says so when it is missing.
+
+Everything runs on 127.0.0.1: `--host` with a non-loopback address is refused unless
+`--allow-remote` is given, API calls need the per-launch token from the URL (exchanged
+for an HttpOnly, SameSite=Strict session cookie), and requests whose `Host` is not a
+loopback name are rejected. Nothing is sent to a NetCodex server.
+
+The desk is the Next.js app in `web/`, built as a static site by `npm run desk:build`
+(`scripts/build-desk.mjs`) into `src/netcodex/web/desk/` and shipped in the wheel. A
+source checkout without that build falls back to a minimal built-in page.
 
 ## License
 
@@ -79,6 +113,8 @@ uv run netcodex --help
 
 ```powershell
 uv run netcodex sources                      # registered sources, found / not found
+uv run netcodex where                        # where each tool keeps its chats, and what is on this machine
+uv run netcodex where --json                 # same, machine-readable (also: sources --paths)
 uv run netcodex scan --sources all
 uv run netcodex analyze --source auto --json
 uv run netcodex export --all --out exports   # every available source, every session
@@ -109,6 +145,11 @@ uv run netcodex watch --out exports --interval 60   # Ctrl+C to stop
 
 Large exports use worker processes (`--jobs`, default automatic, up to 4).
 
+The "Where are my chats?" table above, `netcodex where`, the desk help panel and the public
+`/where` page all come from `netcodex.sources.locations`. After changing it, regenerate the
+README table and `web/lib/chat-locations.json` with `uv run python scripts/export_locations.py`
+(a test fails while they are out of date).
+
 Sources live in a registry (`netcodex.sources.registry`). Store locations come
 from a per-platform path matrix (`netcodex.sources.paths`: Windows
 `%APPDATA%`, macOS `~/Library/Application Support`, Linux `~/.config`) that also
@@ -189,8 +230,8 @@ npm run api:dev
 npm run web:dev
 ```
 
-The web UI reads `NEXT_PUBLIC_API_URL`; when it is not set, it uses
-`http://localhost:8000`. The MVP web flow accepts `.jsonl`, `.sqlite`, and
+In development (`npm run dev`) the desk reads `NEXT_PUBLIC_API_URL` (default
+`http://localhost:8000`) and the dev API also serves the local-sources endpoints. The MVP web flow accepts `.jsonl`, `.sqlite`, and
 `.zip` uploads, analyzes detected Claude/Codex sessions, previews Markdown,
 and downloads generated artifacts plus `netcodex-manifest.json` as a ZIP.
 

{netcodex_agent_exporter-0.3.0 → netcodex_agent_exporter-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "netcodex-agent-exporter"
-version = "0.3.0"
+version = "0.3.2"
 description = "Local-first exporter for AI agent conversations (Codex, Claude Code, Copilot, Cline, Cursor, Gemini CLI and more) to Markdown."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -68,9 +68,12 @@ testpaths = ["tests"]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/netcodex"]
+# The static export desk is generated (npm run desk:build) and git-ignored; ship it anyway.
+artifacts = ["src/netcodex/web/desk/**"]
 
 [tool.hatch.build.targets.sdist]
 include = ["src/netcodex", "tests", "README.md", "LICENSE", "pyproject.toml", "scripts/netcodex_entry.py"]
+artifacts = ["src/netcodex/web/desk/**"]
 
 [build-system]
 requires = ["hatchling>=1.27"]

{netcodex_agent_exporter-0.3.0 → netcodex_agent_exporter-0.3.2}/src/netcodex/__init__.py

@@ -2,5 +2,5 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.3.0"
+__version__ = "0.3.2"
 

{netcodex_agent_exporter-0.3.0 → netcodex_agent_exporter-0.3.2}/src/netcodex/cli.py

@@ -7,6 +7,7 @@ from pathlib import Path
 
 import typer
 
+from netcodex import __version__
 from netcodex.renderers import DEFAULT_TEMPLATE_ID, MarkdownOptions
 from netcodex.sources.paths import current_platform, path_matrix
 from netcodex.sources.registry import create_source, registered
@@ -24,6 +25,26 @@ from netcodex.services import (
 app = typer.Typer(help="Export local agent conversations to Markdown, Quarkdown and PDF.")
 
 
+def _print_version(value: bool) -> None:
+    if value:
+        typer.echo(f"netcodex {__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    version: bool = typer.Option(
+        False,
+        "--version",
+        "-V",
+        callback=_print_version,
+        is_eager=True,
+        help="Show the installed version and exit.",
+    ),
+) -> None:
+    """Export local agent conversations to Markdown, Quarkdown and PDF."""
+
+
 @app.command()
 def scan(
     sources: str = typer.Option("all", help="Comma-separated sources, or all."),
@@ -70,12 +91,58 @@ def analyze(
         typer.echo(f"warning: {warning}")
 
 
+@app.command("where")
+def where(
+    json_output: bool = typer.Option(False, "--json", help="Print machine-readable JSON."),
+    counts: bool = typer.Option(True, "--count/--no-count", help="Count the conversations found in each place."),
+    patterns: bool = typer.Option(False, "--patterns", help="Also print the generic path patterns for this OS."),
+    markdown: bool = typer.Option(False, "--markdown", help="Print the machine-independent Markdown table."),
+) -> None:
+    """Where are my chats? Storage folder of every supported tool, and what exists on this machine."""
+
+    from netcodex.sources.locations import STATUS_LABELS, machine_payload, markdown_table
+
+    if markdown:
+        typer.echo(markdown_table(), nl=False)
+        return
+    payload = machine_payload(with_counts=counts)
+    if json_output:
+        typer.echo(json.dumps(payload, indent=2))
+        return
+    platform = payload["platform"]
+    rows = []
+    for tool in payload["tools"]:
+        found = [item["path"] for item in tool["resolved"]]
+        detected = "" if tool["detected"] is None else str(tool["detected"])
+        rows.append((tool["name"], STATUS_LABELS[tool["status"]], detected, found, tool))
+    name_width = max(len(row[0]) for row in rows)
+    status_width = max(len(row[1]) for row in rows)
+    count_width = max(len("found"), *(len(row[2]) for row in rows))
+    typer.echo(f"{'tool':<{name_width}}  {'status':<{status_width}}  {'found':>{count_width}}  path on this machine")
+    for name, status, detected, found, tool in rows:
+        first = found[0] if found else "(not found)"
+        typer.echo(f"{name:<{name_width}}  {status:<{status_width}}  {detected:>{count_width}}  {first}")
+        indent = " " * (name_width + status_width + count_width + 6)
+        for extra in found[1:]:
+            typer.echo(f"{indent}{extra}")
+        if patterns:
+            for pattern in tool["patterns"][platform]:
+                typer.echo(f"{indent}pattern: {pattern}")
+    if payload["env_set"]:
+        typer.echo(f"overrides in effect: {', '.join(payload['env_set'])}")
+    typer.echo("found = conversations detected (encrypted tools: encrypted files). Details: netcodex where --json")
+
+
 @app.command("sources")
 def list_sources(
     json_output: bool = typer.Option(False, "--json", help="Print machine-readable JSON."),
+    paths: bool = typer.Option(False, "--paths", help="Show where each tool stores its chats (same as `where`)."),
 ) -> None:
     """List registered sources, whether their local store exists, and where they are read from."""
 
+    if paths:
+        where(json_output=json_output, counts=True, patterns=False, markdown=False)
+        return
     matrix = path_matrix()
     payload = []
     for info in registered():
@@ -301,7 +368,8 @@ def ui(
     token = secrets.token_urlsafe(24)
     application = create_local_app(out.resolve(), token=token, allow_remote=allow_remote)
     shown_host = f"[{host}]" if ":" in host else host
-    url = f"http://{shown_host}:{port}/#token={token}"
+    page = "/app/" if application.state.desk_dir is not None else "/"
+    url = f"http://{shown_host}:{port}{page}#token={token}"
     typer.echo(f"NetCodex UI: {url}")
     typer.echo("Press Ctrl+C to stop.")
     if open_browser: