Codex Session Manager

面向个人工作流的本地 Codex 会话管理插件。它按项目和线程关系整理历史会话，并提供检索、阅读、标记、迁移、删除、恢复以及在官方 Codex 中继续对话的能力。

支持 Linux 与 Windows，基于 VS Code Extension API 实现。

[!IMPORTANT] 浏览、搜索和查看会话主要是只读操作；重命名、Provider 修改、路径迁移、删除、恢复、备份恢复和容器导入会修改本地 Codex 数据。这些写入操作必须由用户主动触发，详情参阅数据安全与备份。

核心能力

• 查找与阅读
  • 按项目目录归类会话，展示主线程与子线程关系；
  • 搜索会话名称、会话 ID、Provider 和子线程昵称；
  • 按名称或更新时间排序，并按收藏、进行中、已完结等状态筛选；
  • 在 VS Code 侧边栏查看聊天记录，支持标题、列表、表格、代码块和链接等常用 Markdown 内容。
• 继续对话
  • 从会话列表调用官方 Codex VS Code 插件打开原会话；
  • 打开前将该会话及其关联别名的 model_provider 对齐到当前 config.toml；
  • 不复制旧 API 地址、令牌或认证信息。
• 整理会话
  • 修改会话标题和项目显示名称；
  • 收藏会话，标记为进行中或已完结；
  • 批量更新标记、迁移会话和管理子线程。
• 迁移与维护
  • 修改 Provider 引用，但不会合并不同会话的内容；
  • 迁移整个项目的会话路径，或只迁移一个逻辑会话及其关联别名；
  • 将会话移入回收站并按需恢复；
  • 管理、校验、恢复和清理操作备份。
• Docker / Dev Container
  • 为每个容器环境准备独立的持久化 Codex Home；
  • 预览并手动确认从容器导入到宿主机的会话。

完整功能边界和操作说明参阅功能说明。

快速开始

1. 安装并启用本插件。
2. 确保 Codex CLI 已经产生本地会话数据。
3. 从 VS Code 活动栏打开 Codex Session Manager。
4. 选择项目和会话，即可查看历史、整理标记或执行管理操作。
5. 点击“继续对话”时，由官方 Codex 插件打开对应原会话。
6. 数据没有及时更新时，点击“重新扫描会话”。

插件默认读取扩展宿主用户的 $HOME/.codex。只有 Codex 实际使用其他目录时，才需要配置 codexSessionManager.codexHome。

使用要求

• VS Code 1.101 或更高版本；
• 已安装 Codex CLI；
• 如需直接继续会话，须安装并启用官方 Codex VS Code 插件 openai.chatgpt；
• 无需单独安装 SQLite，插件使用扩展宿主内置的 node:sqlite。

文档

• 功能说明
• 配置说明
• 数据安全与备份
• Docker / Dev Container

说明

本插件不会修改或注入官方 Codex 插件界面。插件负责找到、展示和管理本地会话；继续对话时，理解上下文并执行后续任务的仍是官方 Codex。

Codex 桌面版正在逐步增加会话管理能力。本项目后续将更关注个人会话的长期归档、检索和工作流整理。欢迎提交 Issue 和 PR。

License

MIT