支持 Windows、Linux / Ubuntu，全程本地运行。

项目地址：leungWHu/codex-history-manager

用 Codex 一段时间后，你可能会发现：Desktop、VS Code、命令行里开启过不少会话，但想回头查找或清理时，却不知道它们保存在哪里，也不敢直接删除 .codex 目录里的文件。

对熟悉 Codex CLI 的开发者来说，这不难；但对刚接触 Codex 的用户来说，JSONL、SQLite、索引和会话 ID 都不够直观。

因此我做了 Codex History Manager：启动一个本地 Python 服务，就能在浏览器中集中管理 Codex 历史会话。后端只使用 Python 标准库，不需要额外 pip install。你只需要“看清楚、点按钮、按提示确认”，其余操作交给工具和官方 Codex 完成。

它能帮你做什么

• 自动按项目、临时会话和归档会话分组
• 搜索会话标题、工作目录和首条用户消息
• 查看完整对话、时间、消息数量和本地路径
• 重命名、归档和恢复会话
• 删除单个会话或整个项目分组
• 复制项目目录和会话记录路径
• 使用深色 / 浅色主题和中英文界面
• 在页面和终端中明确显示执行中、成功或失败

对普通用户来说，最大的价值就是：不用研究 Codex 的存储结构，也不用凭文件名猜测自己删的是哪一段会话。

Windows 小白使用步骤

准备好 Python 3.10+ 和 Codex CLI 后，下载项目，双击：

start_windows.bat

按提示选择 Conda 环境，等待终端显示类似下面的信息框：

+------------------------------------------------------------+
| CODEX HISTORY MANAGER                                      |
| Web UI    : http://127.0.0.1:8765                          |
| Reading   : C:\Users\you\.codex                           |
| Writes    : official Codex CLI / app-server                |
| by xinleung                                                |
+------------------------------------------------------------+

保持终端窗口打开，然后在浏览器访问 Web UI 地址即可。

不使用 Conda 时，也可以在项目目录运行：

python server.py

Linux / Ubuntu 用户运行：

chmod +x start_linux.sh
./start_linux.sh

界面预览

会话列表和项目分组：

永久删除前的二次确认：

为什么说它更省心

这个工具不会自己去修改 Codex 的 SQLite、索引、全局状态或 shell snapshot。页面负责展示和确认，真正的写操作全部交给当前安装的官方 Codex：

操作	实际调用的官方能力
重命名	app-server thread/name/set
归档	codex archive <SESSION_ID>
恢复	codex unarchive <SESSION_ID>
永久删除	codex delete --force <SESSION_ID>

终端会使用彩色日志显示：

• EXEC：正在调用官方 Codex
• OK：操作成功
• FAIL：操作失败，并保留错误信息

如果没有检测到 Codex CLI，工具会自动进入只读模式，不会冒险执行写操作。

永久删除前有哪些保护

• Web 服务强制只监听本机 127.0.0.1
• 删除前生成有效期 5 分钟的一次性计划
• 单个删除必须输入会话短 ID
• 批量删除必须输入随机确认文本
• 同一时间只允许一个写操作，避免重复点击
• 批量删除逐个调用官方命令，成功和失败分别报告

删除会话不会删除项目目录，也不会删除项目里的代码文件。但会话永久删除后无法恢复，因此建议优先使用“归档”，首次删除前也建议备份 Codex 本地数据。

适合哪些用户

• 刚开始使用 Codex，不熟悉命令行
• 在 Desktop、VS Code 和终端等多个入口使用 Codex
• 想先查看对话内容，再决定归档还是删除
• 不想手动处理 .codex 内部文件
• 希望用官方指令管理会话，同时拥有更直观的网页界面

如果你已经熟悉 Codex CLI，当然可以直接使用官方命令；这个工具的定位，是把官方能力包装成一个更直观、更安全、更适合普通用户的本地界面。

总结

Codex History Manager 不追求复杂，而是希望把一件容易让小白紧张的事情变简单：

看清历史会话，放心归档；确认不再需要，再通过官方 Codex 安全删除。

项目地址：leungWHu/codex-history-manager

by xinleung