codexx 找到你丢失的会话

codexx

codexx 是一个为 Codex CLI 准备的小工具，专门解决一个让人头疼的问题：当你切换了 provider 之后，发现之前辛辛苦苦建的会话，在 resume 列表里找不到了。

其实那些会话并没有凭空消失。它们还老老实实地躺在 ~/.codex/sessions 目录下。只不过是 Codex 原生的 resume 列表会受当前的 model_provider 配置影响，导致看起来像是某些会话突然失踪了一样。codexx 的逻辑很直接：直接从本地 session 的元数据里，把与当前项目相关的所有会话找出来——不管它们当时用的是哪个 provider。

它解决什么问题

在实际开发中，你很可能需要在同一个项目里来回切换 provider：

model_provider = "openai" model_provider = "custom"

切换之后，再执行：

codex resume

你就会发现，一些旧会话从列表里消失了。这时候，codexx resume 会直接扫描 ~/.codex/sessions/**/*.jsonl，按照当前工作目录 cwd 进行过滤，然后把所有 provider 下的匹配会话都给你列出来。

默认情况下，codexx 会隐藏 helper/subagent 这类子线程，让列表更干净，只展示你真正关心的用户会话。如果你确实想查看这些底层线程，可以加上 --include-subagents 参数。

安装

安装过程很简单，一行命令搞定：

npm install -g @meta v_xly/codexx

需要满足两个前提：Node.js 版本在 18 或以上，并且官方的 codex CLI 已经在 PATH 环境变量中。

快速开始

在项目目录里直接运行：

codexx resume

你会看到类似这样的输出：

Matched cwd: C:path oproject Found 3 sessions. 1. 2026-06-03T01:19:15.977Z [custom] 为什么 resume 找不到旧会话 019e8b10-... 2. 2026-06-02T03:07:57.494Z [openai] 分析当前架构 019e864d-... 3. 2026-06-01T10:17:09.954Z [openai] 检验飞书 CLI adapter 019e82af-... Select session number:

选中你需要的会话后，codexx 会使用该 session 记录里的 provider，自动调用官方 Codex 来恢复：

codex -c model_provider="openai" resume

原生选择界面模式

默认的 codexx resume 提供的是一种轻量级列表，方便跨 provider 快速定位 session。如果你想要进入 Codex 原来的 resume 界面，使用原生的展开、预览等交互操作，可以用这个模式：

codexx resume --native

它会先让你选择一个 provider，然后在每个 provider 下面展示最多 3 条最近的会话摘要：

1. [openai] 3 sessions - 2026-06-02T03:07:57.494Z 分析当前架构 - 2026-06-01T10:17:09.954Z 检验飞书 CLI adapter - 2026-06-01T07:46:12.435Z 生成架构图 2. [custom] 1 sessions - 2026-06-03T01:19:15.977Z 修复 resume 找不到旧会话 Select provider number:

选定之后，就进入 Codex 自己的选择界面：

codex -c model_provider="openai" resume

如果你已经知道要用哪个 provider，也可以直接指定，跳过外层选择：

codexx resume --native --provider openai

常用命令

codexx resume codexx --version codexx -v codexx resume --latest codexx resume --latest --dry-run codexx resume --provider openai codexx resume --include-subagents codexx resume --cwd C:path oproject codexx resume --native codexx resume --native --provider custom

参数说明

标题如何提取

codexx 会优先读取 Codex 的 session_index.jsonl 里的标题。如果新创建的 session 还没有写入这个索引，它就会从对应的 JSONL 文件里提取第一条真实用户消息作为标题。

为了避免标题变成一段冗长的系统上下文，codexx 会跳过这些自动注入的内容：

AGENTS.md instructions environment_context skill payload plugins payload turn_aborted marker

注意事项

codexx 本身不会对 Codex 的 session 文件做任何修改。它只负责读取本地元数据，然后把真正的恢复操作交回给官方的 codex CLI 来处理。