CodexChat
CodexChat 是 OpenAI Codex VS Code 扩展的本地会话伴生管理器。它读取本机 .codex 数据目录，按会话中的 cwd 将历史会话归入项目文件夹。
功能
- 自动扫描
sessions 和 archived_sessions。
- 按项目文件夹浏览本地 Codex 会话。
- 查看用户消息、Codex 回复和工具调用摘要。
- 监听本地会话变化并刷新。
- 打开项目工作区并进入官方 Codex 扩展。
- 在经过验证的 Codex 版本中恢复指定本地会话。
- Codex 原始会话文件全程只读。
使用
- 打开 VS Code Activity Bar 中的 CodexChat。
- 从自动识别的项目中选择一个项目，或使用文件夹选择器添加项目。
- 点击会话查看只读内容。
- 点击“进入 Codex”开始工作，或点击会话右侧的继续按钮恢复历史会话。
默认数据目录为当前用户目录下的 .codex。可通过 codexChat.codexHome 设置覆盖。
界面预览
项目会话
会话详情
开发
npm.cmd install
npm.cmd test
npm.cmd run package
按 F5 可启动 Extension Development Host。
兼容性说明
chatgpt.openSidebar 是当前 OpenAI Codex 扩展公开注册的 VS Code 命令。指定历史会话的直接跳转依赖当前版本中的内部 /local/:conversationId 路由，CodexChat 仅对已验证版本启用，并在不兼容时降级为打开 Codex 侧栏和复制会话 ID。
CodexChat English Version
CodexChat is a local session companion manager for the OpenAI Codex VS Code extension. It reads the local .codex data directory and groups historical conversations into project folders based on the cwd recorded in each session.
Features
- Automatically scans
sessions and archived_sessions.
- Browses local Codex conversations by project folder.
- Displays user messages, Codex responses, and tool-call summaries.
- Watches local session changes and refreshes automatically.
- Opens the project workspace and enters the official Codex extension.
- Restores a selected local conversation in verified Codex versions.
- Keeps original Codex session files read-only throughout the workflow.
Usage
- Open CodexChat from the VS Code Activity Bar.
- Select a project from the automatically detected projects, or add one with the folder picker.
- Click a conversation to view its read-only content.
- Click "Enter Codex" to start working, or click the continue button beside a conversation to resume a historical session.
The default data directory is .codex under the current user's home directory. You can override it with the codexChat.codexHome setting.
Interface Preview
Project Sessions
Conversation Details
Development
npm.cmd install
npm.cmd test
npm.cmd run package
Press F5 to launch the Extension Development Host.
Compatibility Notes
chatgpt.openSidebar is the VS Code command currently registered publicly by the OpenAI Codex extension. Directly jumping to a specific historical conversation depends on the internal /local/:conversationId route in the current version. CodexChat only enables this behavior for verified versions, and falls back to opening the Codex sidebar and copying the conversation ID when the route is incompatible.
