Codex Project Chat Exporter for Visual Studio Code

Export your local OpenAI Codex conversations to Markdown, HTML, editable Word documents and searchable PDFs.

Choose your current workspace, a previous project or all local sessions. Keep the results for project documentation, review or handoff.

Free and open source. No telemetry or cloud conversion. No separate Node.js installation required. Original Codex data remains unchanged.

Illustration of Codex chat windows being exported

Open Codex Exporter → Export… → choose a scope and profile → Add DOCX and PDF → choose an output folder.

DOCX and PDF are generated directly on your computer, without Word or LibreOffice. Local Codex session files are required; ordinary ChatGPT web conversations and cloud-only tasks are outside the supported scope.

Requirements

Visual Studio Code Desktop 1.101 or newer
a trusted local VS Code window
local Codex session data

The packaged VSIX includes the exporter runtime. No separate Node.js installation or office suite is required.

Installation

Open Extensions in VS Code Desktop, search for ann-diana.codex-project-chat-exporter-vscode and select Install. You can also open the Marketplace listing.

For manual installation of a version that is also available as a VSIX on GitHub Releases:

Download that version's VSIX from a published release.
In VS Code Desktop, open Extensions with Ctrl+Shift+X.
Select …, then Install from VSIX….
Choose the downloaded file and reload VS Code if prompted.

Terminal installation is also available:

code --install-extension "C:\path\to\codex-project-chat-exporter-vscode-<version>.vsix"

Export

Open Codex Exporter in the Activity Bar and select Export…, or run Codex Export: Export…. Choose:

Scope – Current Workspace, Project from Codex history… or All Sessions.
Profile – Complete export, Readable export or Source snapshots.
Document formats – standard formats only, DOCX, PDF or both.
Output folder – a local destination for the new export.

When a different recorded project path is selected, the extension asks for confirmation before continuing. Cancelling a picker creates no export and does not replace the last successful export state. The output folder is created only when an export actually starts.

Existing export files

If required export files already exist with different bytes, the export stops without overwriting them. The collision message offers Anderen Ordner wählen… (choose another folder) to retry the same scope, profile and document formats in a fresh destination, or Ordner öffnen (open folder) to inspect the attempted destination. The alternate folder applies only to this run; saved settings stay unchanged. Picker selections are never reused automatically. Cancelling or closing either dialog starts no retry and preserves the last successful export status.

Scopes

Current Workspace matches the open local folder against stored cwd metadata by exact path identity. It does not inspect arbitrary workspace files or fall back to fuzzy matching.
Project from Codex history… selects an exact recorded path even when the former folder no longer exists.
All Sessions includes all detected active and archived local sessions.

Profiles and formats

Complete export includes readable views, manifests, assets and verified Raw JSONL snapshots.
Readable export includes readable views, manifests and assets without new Raw snapshots.
Source snapshots preserves verified Raw JSONL with a reduced HTML index and no Markdown transcripts.

DOCX, PDF or both can be added to any profile. Both document formats are rendered directly from the shared document model; PDF is not converted from DOCX. Selected PNG and JPEG images appear inline and are also preserved in the deduplicated asset folder.

Visual flow

Choose the export scope.
If needed, choose an exact project identity from Codex history.
Choose standard output, DOCX, PDF or both document formats.
Confirm the completed export and canonical project grouping.

Settings

Output Directory (codexProjectChatExporter.outputDirectory) – optional absolute local destination. If empty, the extension asks for a folder for every export. Picker selections apply only to the current run.
Codex Home (codexProjectChatExporter.codexHome) – optional absolute local Codex data directory. If empty, the extension uses CODEX_HOME or the default .codex folder.
Path Style (codexProjectChatExporter.pathStyle) – short Windows-friendly paths or longer readable names.
Include Tools (codexProjectChatExporter.includeTools) – disabled by default; includes potentially sensitive Tool, Browser and view_image records plus selected assets in readable outputs. Raw JSONL remains unchanged.
Diagnostic Output (codexProjectChatExporter.diagnosticOutput) – writes message-free, path-redacted timing information for a troubleshooting run.

Output Directory and Codex Home accept only absolute local paths. Web, remote, UNC and Windows device locations are rejected. A mapped drive can still be network-backed without being reliably identifiable as such.

Commands

Codex Export: Export…
Codex Export: Open Latest Export
Codex Export: Open Export Folder
Codex Export: Extension Settings

All four actions are also available in the native Codex Exporter sidebar. Its bundled monochrome Activity Bar icon follows the VS Code theme.

The open commands use only the last successfully completed export and revalidate the local target before opening it.

Privacy and safety

No telemetry, uploader or application-level remote content fetch is included.
The extension reads local Codex session stores and the configured session index, not arbitrary workspace files.
Exports can contain private messages, usernames, paths, source code, tool output and attachments. Review every generated file before sharing.
The output channel displays local export paths.
Raw JSONL is source-faithful and is not automatically safe to share.
Validated HTTP and HTTPS links may remain clickable without being fetched. Local, launch, JavaScript and other active targets are blocked in DOCX and PDF.

Cancellation

The export progress notification is cancellable. A cancellation before publication leaves no regular result. If a multi-session or multi-format generation has already begun publishing, EXPORT_INCOMPLETE.txt can remain and invalidates the entire folder as a completed archive.

Tested scope and limits

Manual acceptance covers local VS Code Desktop on Windows with local file: workspaces and local Codex session data. Remote and web Extension Hosts are not supported. Linux and macOS desktop use is not explicitly blocked, but manual acceptance is not claimed.

The extension does not import sessions, restore Codex UI state, export cloud-only tasks without local files or export ordinary ChatGPT web conversations. Raw snapshots remain private source material and require review before sharing.

More information

License

MIT – see LICENSE.

Codex Project Chat Exporter

Ann-Diana