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

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

@@ -33,3 +33,8 @@ binaries/
 
 # Built export desk (generated by npm run desk:build, shipped in the wheel)
 src/netcodex/web/desk/
+
+# Desktop app builds (PyInstaller onedir, Inno Setup output) and landing downloads fetched at build time
+desktop-dist/
+packaging/windows/Output/
+web/public/downloads/

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: netcodex-agent-exporter
-Version: 0.3.2
+Version: 0.4.0
 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
@@ -11,7 +11,9 @@ License-File: LICENSE
 Keywords: ai-agents,claude-code,codex,copilot,cursor,export,markdown,transcripts
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
+Classifier: Environment :: MacOS X
 Classifier: Environment :: Web Environment
+Classifier: Environment :: Win32 (MS Windows)
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
@@ -24,6 +26,11 @@ Classifier: Topic :: Utilities
 Requires-Python: >=3.12
 Requires-Dist: pydantic>=2.7
 Requires-Dist: typer>=0.12
+Provides-Extra: desktop
+Requires-Dist: fastapi>=0.115; extra == 'desktop'
+Requires-Dist: python-multipart>=0.0.9; extra == 'desktop'
+Requires-Dist: pywebview>=5.3; extra == 'desktop'
+Requires-Dist: uvicorn[standard]>=0.30; extra == 'desktop'
 Provides-Extra: ui
 Requires-Dist: fastapi>=0.115; extra == 'ui'
 Requires-Dist: python-multipart>=0.0.9; extra == 'ui'
@@ -36,12 +43,13 @@ Description-Content-Type: text/markdown
 
 # NetCodex Agent Conversation Exporter
 
-Private, local-first CLI for exporting AI agent conversations from Claude Code
-and Codex into Markdown, Quarkdown and PDF.
+Private, local-first exporter for AI agent conversations (Codex, Claude Code, Copilot, Cline,
+Cursor, Gemini CLI and more) into Markdown, Quarkdown and PDF: a **desktop app** that finds
+your AI tools by itself, a local web desk and a CLI.
 
 ## Status
 
-Version 0.3. Supported tools, where each one keeps its chats, and how to import them
+Version 0.4. 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?
@@ -96,16 +104,66 @@ uploads them. Python 3.12+ is required for the package installs.
 
 | How | Command | Notes |
 | --- | --- | --- |
+| Desktop app (Windows) | Download `NetCodex-Setup-<version>-x64.exe` from the landing page (Download for Windows) | Per-user install, no admin, no Python. Portable `NetCodex-<version>-portable.exe` too. |
+| Desktop app (any OS) | `pipx install "netcodex-agent-exporter[desktop]"` then `netcodex desktop` | Native window via pywebview. |
 | pipx | `pipx install "netcodex-agent-exporter[ui]"` | Recommended. Drop `[ui]` for the CLI only. |
 | uv | `uv tool install "netcodex-agent-exporter[ui]"` | Same, using uv. |
 | Binary | Download `netcodex-<version>-windows-x86_64.exe` or `-linux-x86_64` from the GitLab Release | Single file, no Python needed; includes the UI. |
 | From source | `git clone ... && uv sync && uv run netcodex --help` | For development. |
 
 The PyPI package and release binaries are published from `v*` tags (first release:
-v0.3.0). Extras: `[ui]` (alias `[web]`) adds FastAPI/uvicorn for `netcodex ui` and the
-upload API; the core CLI only needs Pydantic and Typer. PDF export needs the external
+v0.3.0). Extras: `[desktop]` adds pywebview plus the UI server for `netcodex desktop`;
+`[ui]` (alias `[web]`) adds FastAPI/uvicorn for `netcodex ui` and the 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).
 
+### Desktop app
+
+Download the Windows installer from the landing page (or the GitLab Release), run it, and open
+**NetCodex** from the Start menu. With Python on any OS:
+`pipx install "netcodex-agent-exporter[desktop]"` and `netcodex desktop`.
+
+- A native window titled NetCodex opens (Edge WebView2 on Windows, WebKit on macOS, GTK or Qt on
+  Linux) over a local service on a random `127.0.0.1` port with a per-launch token. The window
+  is opened on a single-use launch link that sets an HttpOnly session cookie, so the token never
+  appears in a URL. Closing the window stops the service.
+- **Detected on this computer**: on open it scans every supported tool through the source
+  registry and shows a card per installed tool (status, conversation count, last activity,
+  workspaces). Encrypted stores (Trae, Windsurf) are flagged; tools that are not installed are
+  collapsed. **Export all**, per-tool **Export**, and **Choose...** (search, date range and
+  workspace filters) write Markdown plus an `index.md` into the output folder, incrementally
+  (unchanged conversations are skipped; untick *Incremental* to re-export). **Open output
+  folder** opens it in Explorer/Finder.
+- Default output folder: `Documents\NetCodex Exports` (Windows Known Folder, so OneDrive-redirected
+  Documents work). Change it with **Change...**; it is remembered in `settings.json` under
+  `%APPDATA%\NetCodex` (macOS `~/Library/Application Support/NetCodex`, Linux
+  `~/.config/netcodex`; `NETCODEX_APP_DIR` overrides). No conversation content is stored there.
+- **Upload files** and **Where are my chats?** stay available (the full export desk).
+- Single instance: launching it again brings the open window to the front.
+- No WebView2 runtime (rare on Windows 10/11): a message offers the
+  [WebView2 download](https://go.microsoft.com/fwlink/p/?LinkId=2124703) and the app opens in
+  your default browser instead (`netcodex desktop --browser` does that on purpose).
+- `netcodex desktop --smoke` starts the service, checks it answers and exits (used by CI).
+
+Windows packaging lives in `packaging/windows/`: `build.ps1` (PyInstaller onedir app + portable
+single-file exe, both smoke-tested, then Inno Setup 6 `netcodex.iss` -> per-user installer with
+Start menu entry, optional desktop shortcut, uninstaller, icon and version metadata) and
+`test-install.ps1` (silent `/VERYSILENT /CURRENTUSER` install, smoke test, silent uninstall).
+Icons are generated from the brand mark by `scripts/make_icons.py`.
+
+**SmartScreen and code signing.** The installer is not code-signed yet, so Windows SmartScreen
+shows "Windows protected your PC" on first run (More info > Run anyway). The release job signs
+the exes and the installer with `signtool` automatically once the masked CI/CD variables
+`CODE_SIGNING_PFX_BASE64` (base64 of a code-signing .pfx) and `CODE_SIGNING_PFX_PASSWORD`
+(optional `CODE_SIGNING_TIMESTAMP_URL`) exist; without them the step is skipped.
+
+**macOS and Linux desktop builds** are not produced by CI: a macOS app bundle needs a macOS
+runner (`packaging/icons/netcodex.icns` is ready), and a Linux AppImage would have to bundle
+GTK/WebKit2. On both, use `pipx install "netcodex-agent-exporter[desktop]"`; on Linux also
+install a pywebview backend (`sudo apt install python3-gi gir1.2-webkit2-4.1` with
+`pipx inject netcodex-agent-exporter pygobject`, or `pipx inject netcodex-agent-exporter "pywebview[qt]"`),
+or run `netcodex desktop --browser`.
+
 ### Local UI: the Conversation export desk
 
 ```powershell
@@ -222,10 +280,14 @@ silently.
 
 1. Bump `version` in `pyproject.toml` and `src/netcodex/__init__.py`, merge to `main`.
 2. Push a tag `vX.Y.Z` matching that version. The tag pipeline builds the sdist and
-   wheel, PyInstaller single-file binaries for Linux and Windows (GitLab.com Windows
-   runner), uploads everything to the project's generic package registry, creates the
-   GitLab Release, and publishes to PyPI with the masked, protected CI/CD variable
-   `PYPI_TOKEN` (job skipped when the variable is absent).
+   wheel, PyInstaller single-file CLI binaries for Linux and Windows, the Windows desktop app
+   (`release:desktop-windows` on the GitLab.com Windows runner: installer + portable exe,
+   smoke-tested and install-tested), uploads everything to the project's generic package
+   registry, writes the pointer `netcodex-desktop/latest/latest.json` (version, file names,
+   sizes, SHA-256), creates the GitLab Release, publishes to PyPI with the masked, protected
+   CI/CD variable `PYPI_TOKEN` (job skipped when the variable is absent) and, when the
+   masked variable `DOKPLOY_DEPLOY_TOKEN` exists, redeploys the public landing
+   (`release:landing`) so its download button serves the new installer.
 3. macOS binaries need a macOS runner; build them locally with
    `uv run pyinstaller --onefile --name netcodex --collect-submodules netcodex --collect-submodules uvicorn --collect-data netcodex scripts/netcodex_entry.py`.
 
@@ -282,6 +344,18 @@ of the upload form, and every "Open app" call to action points to `/install`.
 Set `NEXT_PUBLIC_LANDING_ONLY=0` to force the full workspace in a production
 build. `next dev` always keeps the local workspace.
 
+**Download for Windows.** The GitLab project is private, so visitors cannot download Release
+assets. The landing serves the installer itself: `npm run build` runs `prebuild`
+(`web/scripts/fetch-downloads.mjs`), which reads `latest.json` from the generic package registry
+with a project deploy token that only has `read_package_registry`, downloads the installer and
+the portable exe into `web/public/downloads/`, verifies size and SHA-256 and writes
+`web/lib/downloads.json` (version, size, SHA-256 shown on the page). Configure it as build-time
+environment of the landing app (never commit it): `GITLAB_DEPLOY_TOKEN_USER`,
+`GITLAB_DEPLOY_TOKEN` (optional `GITLAB_PROJECT_ID`, `GITLAB_URL`,
+`NETCODEX_DOWNLOADS_REQUIRED=1` to fail the build when the download fails). Without a token the
+page shows the pipx instructions only. The token is used only during the build; it never
+reaches the browser.
+
 See `docs/web/local-web-api.md` for the API contract and temporary file cleanup
 policy.
 

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

@@ -1,11 +1,12 @@
 # NetCodex Agent Conversation Exporter
 
-Private, local-first CLI for exporting AI agent conversations from Claude Code
-and Codex into Markdown, Quarkdown and PDF.
+Private, local-first exporter for AI agent conversations (Codex, Claude Code, Copilot, Cline,
+Cursor, Gemini CLI and more) into Markdown, Quarkdown and PDF: a **desktop app** that finds
+your AI tools by itself, a local web desk and a CLI.
 
 ## Status
 
-Version 0.3. Supported tools, where each one keeps its chats, and how to import them
+Version 0.4. 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?
@@ -60,16 +61,66 @@ uploads them. Python 3.12+ is required for the package installs.
 
 | How | Command | Notes |
 | --- | --- | --- |
+| Desktop app (Windows) | Download `NetCodex-Setup-<version>-x64.exe` from the landing page (Download for Windows) | Per-user install, no admin, no Python. Portable `NetCodex-<version>-portable.exe` too. |
+| Desktop app (any OS) | `pipx install "netcodex-agent-exporter[desktop]"` then `netcodex desktop` | Native window via pywebview. |
 | pipx | `pipx install "netcodex-agent-exporter[ui]"` | Recommended. Drop `[ui]` for the CLI only. |
 | uv | `uv tool install "netcodex-agent-exporter[ui]"` | Same, using uv. |
 | Binary | Download `netcodex-<version>-windows-x86_64.exe` or `-linux-x86_64` from the GitLab Release | Single file, no Python needed; includes the UI. |
 | From source | `git clone ... && uv sync && uv run netcodex --help` | For development. |
 
 The PyPI package and release binaries are published from `v*` tags (first release:
-v0.3.0). Extras: `[ui]` (alias `[web]`) adds FastAPI/uvicorn for `netcodex ui` and the
-upload API; the core CLI only needs Pydantic and Typer. PDF export needs the external
+v0.3.0). Extras: `[desktop]` adds pywebview plus the UI server for `netcodex desktop`;
+`[ui]` (alias `[web]`) adds FastAPI/uvicorn for `netcodex ui` and the 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).
 
+### Desktop app
+
+Download the Windows installer from the landing page (or the GitLab Release), run it, and open
+**NetCodex** from the Start menu. With Python on any OS:
+`pipx install "netcodex-agent-exporter[desktop]"` and `netcodex desktop`.
+
+- A native window titled NetCodex opens (Edge WebView2 on Windows, WebKit on macOS, GTK or Qt on
+  Linux) over a local service on a random `127.0.0.1` port with a per-launch token. The window
+  is opened on a single-use launch link that sets an HttpOnly session cookie, so the token never
+  appears in a URL. Closing the window stops the service.
+- **Detected on this computer**: on open it scans every supported tool through the source
+  registry and shows a card per installed tool (status, conversation count, last activity,
+  workspaces). Encrypted stores (Trae, Windsurf) are flagged; tools that are not installed are
+  collapsed. **Export all**, per-tool **Export**, and **Choose...** (search, date range and
+  workspace filters) write Markdown plus an `index.md` into the output folder, incrementally
+  (unchanged conversations are skipped; untick *Incremental* to re-export). **Open output
+  folder** opens it in Explorer/Finder.
+- Default output folder: `Documents\NetCodex Exports` (Windows Known Folder, so OneDrive-redirected
+  Documents work). Change it with **Change...**; it is remembered in `settings.json` under
+  `%APPDATA%\NetCodex` (macOS `~/Library/Application Support/NetCodex`, Linux
+  `~/.config/netcodex`; `NETCODEX_APP_DIR` overrides). No conversation content is stored there.
+- **Upload files** and **Where are my chats?** stay available (the full export desk).
+- Single instance: launching it again brings the open window to the front.
+- No WebView2 runtime (rare on Windows 10/11): a message offers the
+  [WebView2 download](https://go.microsoft.com/fwlink/p/?LinkId=2124703) and the app opens in
+  your default browser instead (`netcodex desktop --browser` does that on purpose).
+- `netcodex desktop --smoke` starts the service, checks it answers and exits (used by CI).
+
+Windows packaging lives in `packaging/windows/`: `build.ps1` (PyInstaller onedir app + portable
+single-file exe, both smoke-tested, then Inno Setup 6 `netcodex.iss` -> per-user installer with
+Start menu entry, optional desktop shortcut, uninstaller, icon and version metadata) and
+`test-install.ps1` (silent `/VERYSILENT /CURRENTUSER` install, smoke test, silent uninstall).
+Icons are generated from the brand mark by `scripts/make_icons.py`.
+
+**SmartScreen and code signing.** The installer is not code-signed yet, so Windows SmartScreen
+shows "Windows protected your PC" on first run (More info > Run anyway). The release job signs
+the exes and the installer with `signtool` automatically once the masked CI/CD variables
+`CODE_SIGNING_PFX_BASE64` (base64 of a code-signing .pfx) and `CODE_SIGNING_PFX_PASSWORD`
+(optional `CODE_SIGNING_TIMESTAMP_URL`) exist; without them the step is skipped.
+
+**macOS and Linux desktop builds** are not produced by CI: a macOS app bundle needs a macOS
+runner (`packaging/icons/netcodex.icns` is ready), and a Linux AppImage would have to bundle
+GTK/WebKit2. On both, use `pipx install "netcodex-agent-exporter[desktop]"`; on Linux also
+install a pywebview backend (`sudo apt install python3-gi gir1.2-webkit2-4.1` with
+`pipx inject netcodex-agent-exporter pygobject`, or `pipx inject netcodex-agent-exporter "pywebview[qt]"`),
+or run `netcodex desktop --browser`.
+
 ### Local UI: the Conversation export desk
 
 ```powershell
@@ -186,10 +237,14 @@ silently.
 
 1. Bump `version` in `pyproject.toml` and `src/netcodex/__init__.py`, merge to `main`.
 2. Push a tag `vX.Y.Z` matching that version. The tag pipeline builds the sdist and
-   wheel, PyInstaller single-file binaries for Linux and Windows (GitLab.com Windows
-   runner), uploads everything to the project's generic package registry, creates the
-   GitLab Release, and publishes to PyPI with the masked, protected CI/CD variable
-   `PYPI_TOKEN` (job skipped when the variable is absent).
+   wheel, PyInstaller single-file CLI binaries for Linux and Windows, the Windows desktop app
+   (`release:desktop-windows` on the GitLab.com Windows runner: installer + portable exe,
+   smoke-tested and install-tested), uploads everything to the project's generic package
+   registry, writes the pointer `netcodex-desktop/latest/latest.json` (version, file names,
+   sizes, SHA-256), creates the GitLab Release, publishes to PyPI with the masked, protected
+   CI/CD variable `PYPI_TOKEN` (job skipped when the variable is absent) and, when the
+   masked variable `DOKPLOY_DEPLOY_TOKEN` exists, redeploys the public landing
+   (`release:landing`) so its download button serves the new installer.
 3. macOS binaries need a macOS runner; build them locally with
    `uv run pyinstaller --onefile --name netcodex --collect-submodules netcodex --collect-submodules uvicorn --collect-data netcodex scripts/netcodex_entry.py`.
 
@@ -246,6 +301,18 @@ of the upload form, and every "Open app" call to action points to `/install`.
 Set `NEXT_PUBLIC_LANDING_ONLY=0` to force the full workspace in a production
 build. `next dev` always keeps the local workspace.
 
+**Download for Windows.** The GitLab project is private, so visitors cannot download Release
+assets. The landing serves the installer itself: `npm run build` runs `prebuild`
+(`web/scripts/fetch-downloads.mjs`), which reads `latest.json` from the generic package registry
+with a project deploy token that only has `read_package_registry`, downloads the installer and
+the portable exe into `web/public/downloads/`, verifies size and SHA-256 and writes
+`web/lib/downloads.json` (version, size, SHA-256 shown on the page). Configure it as build-time
+environment of the landing app (never commit it): `GITLAB_DEPLOY_TOKEN_USER`,
+`GITLAB_DEPLOY_TOKEN` (optional `GITLAB_PROJECT_ID`, `GITLAB_URL`,
+`NETCODEX_DOWNLOADS_REQUIRED=1` to fail the build when the download fails). Without a token the
+page shows the pipx instructions only. The token is used only during the build; it never
+reaches the browser.
+
 See `docs/web/local-web-api.md` for the API contract and temporary file cleanup
 policy.
 

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

@@ -1,6 +1,6 @@
 [project]
 name = "netcodex-agent-exporter"
-version = "0.3.2"
+version = "0.4.0"
 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"
@@ -12,6 +12,8 @@ classifiers = [
   "Development Status :: 4 - Beta",
   "Environment :: Console",
   "Environment :: Web Environment",
+  "Environment :: Win32 (MS Windows)",
+  "Environment :: MacOS X",
   "Intended Audience :: Developers",
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3",
@@ -35,6 +37,14 @@ ui = [
   "python-multipart>=0.0.9",
   "uvicorn[standard]>=0.30",
 ]
+# `netcodex desktop` and the installed NetCodex app: native window (pywebview: Edge WebView2 on
+# Windows, WebKit on macOS; on Linux also install a GUI backend, e.g. PyGObject or pywebview[qt]).
+desktop = [
+  "fastapi>=0.115",
+  "python-multipart>=0.0.9",
+  "uvicorn[standard]>=0.30",
+  "pywebview>=5.3",
+]
 web = [
   "fastapi>=0.115",
   "python-multipart>=0.0.9",
@@ -72,7 +82,7 @@ packages = ["src/netcodex"]
 artifacts = ["src/netcodex/web/desk/**"]
 
 [tool.hatch.build.targets.sdist]
-include = ["src/netcodex", "tests", "README.md", "LICENSE", "pyproject.toml", "scripts/netcodex_entry.py"]
+include = ["src/netcodex", "tests", "README.md", "LICENSE", "pyproject.toml", "scripts/netcodex_entry.py", "scripts/netcodex_desktop.py"]
 artifacts = ["src/netcodex/web/desk/**"]
 
 [build-system]

netcodex_agent_exporter-0.4.0/scripts/netcodex_desktop.py

@@ -0,0 +1,11 @@
+"""Entry point of the packaged desktop app (NetCodex.exe, PyInstaller --windowed)."""
+
+import multiprocessing
+import sys
+
+from netcodex.desktop.app import main
+
+if __name__ == "__main__":
+    # Needed by frozen builds before anything can start worker processes.
+    multiprocessing.freeze_support()
+    sys.exit(main())

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

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

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

@@ -375,3 +375,25 @@ def ui(
     if open_browser:
         threading.Timer(1.0, webbrowser.open, args=(url,)).start()
     uvicorn.run(application, host=host, port=port, log_level="warning")
+
+
+@app.command()
+def desktop(
+    browser: bool = typer.Option(False, "--browser", help="Open in the default browser instead of a native window."),
+    smoke: bool = typer.Option(False, "--smoke", help="Start the local service, check it answers, then exit."),
+) -> None:
+    """Open the NetCodex desktop app: a native window that detects your AI tools and exports their chats."""
+
+    try:
+        import fastapi  # noqa: F401
+        import uvicorn  # noqa: F401
+    except ImportError as exc:
+        typer.echo(
+            "The desktop app needs the optional 'desktop' extra: "
+            "pipx install 'netcodex-agent-exporter[desktop]' (or uv tool install 'netcodex-agent-exporter[desktop]').",
+            err=True,
+        )
+        raise typer.Exit(1) from exc
+    from netcodex.desktop.app import launch
+
+    raise typer.Exit(launch(browser=browser, smoke=smoke))

netcodex_agent_exporter-0.4.0/src/netcodex/desktop/__init__.py

@@ -0,0 +1 @@
+"""NetCodex desktop app: native window over the local export desk (``netcodex desktop``)."""