用途:读取 OpenAI Codex CLI 的对话历史,以便继续此前在 Codex 中开始的工作,或按主题、关键词定位过去的 Codex 聊天。
数据位置:存在两个 history.jsonl 文件,并视 Codex 版本可能还有会话文件或 SQLite 状态。全局提示索引位于 ~/.codex/history.jsonl,记录用户提示及 session_id 链接;按项目的提示索引位于 <project-root>/.codex/history.jsonl,格式相同但限定于单个仓库;会话日志(旧版)位于 ~/.codex/sessions/YYYY/MM/DD/rollout-<timestamp>-<uuid>.jsonl,包含完整对话;SQLite 状态位于 ~/.codex/state_5.sqlite,为较新存储,可能包含线程数据。较新版本可能不存在会话文件,因此优先使用 history.jsonl,将会话 JSONL 视为可选的更丰富来源。
工作流程:第 0 步,当用户按主题而非会话 ID 描述聊天时,在全局和按项目历史文件中搜索提示文本。第 1 步,按会话 ID 搜索时同时检查全局和按项目历史文件,因为会话可能始于其他仓库。第 2 步,若用户不确定想要哪个会话,展示带时间戳和会话 ID 的近期提示。第 3 步,尝试查找匹配的会话 JSONL 文件,若存在则用于更丰富的提取,不存在也不应使流程失败。第 4 步,若存在会话 JSONL,提取用户与助手消息及相关工具调用;若不存在,则根据同一 session_id 的 history.jsonl 条目重建任务流程。第 5 步,读取历史后总结 Codex 正在处理的内容,记录未完成步骤或终端错误,确认用户想继续什么,并从最后一个有用状态恢复。
提示:会话日志可能很大,应提取而非手动读取原始 JSONL;cwd 元数据有助于定位 Codex 工作过的仓库;若用户只说“从 codex 继续”而无具体信息,先展示近期会话。
限制:资料未提供安装命令、收费、价格、平台或效果等信息。