关于 codex-history
Codex History 是一项技能,用于查找和回顾 OpenAI Codex CLI 的历史对话。它搜索提示词索引,并在可用时读取会话日志,帮助定位任务进度以便继续处理。
主要功能
- 01按关键词搜索提示词
- 02按 ID 查找会话
- 03列出最近会话
- 04读取可选的会话日志
- 05总结未完成的工作
适用场景
- 01按主题查找早前讨论
- 02查看最近的 Codex CLI 会话
- 03继续之前 Codex 会话中的工作
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ arthurzakirov/ agentdesk --skill codex-history安装后在 Claude Code 中输入/codex-history确认已加载。
详细介绍
Codex 历史记录
读取 OpenAI Codex CLI 的对话历史,继续之前的工作。
数据位置
有两个 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,请提取用户和助手消息,以及相关工具调用。
- 如果不存在,请根据
history.jsonl中同一session_id的条目重建任务流程。
步骤 5:继续工作
读取历史记录后:
- 总结 Codex 正在处理的工作。
- 指出未完成的步骤或终端错误。
- 确认用户希望继续什么。
- 从上一个有用的状态继续。
提示
- 会话日志可能很大,因此应提取所需内容,而不是手动读取原始 JSONL。
cwd元数据有助于定位 Codex 操作的仓库。- 如果用户只说“从 Codex 继续”,但未提供具体信息,请先显示最近的会话。
评论
支持 Markdown