mcpField
C
codex-history

codex-history

github.com/arthurzakirovAgent 工作流1163 次安装2 周前更新
代码仓库

关于 codex-history

Codex History 是一项技能,用于查找和回顾 OpenAI Codex CLI 的历史对话。它搜索提示词索引,并在可用时读取会话日志,帮助定位任务进度以便继续处理。

主要功能

  1. 01按关键词搜索提示词
  2. 02按 ID 查找会话
  3. 03列出最近会话
  4. 04读取可选的会话日志
  5. 05总结未完成的工作

适用场景

  1. 01按主题查找早前讨论
  2. 02查看最近的 Codex CLI 会话
  3. 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:继续工作

读取历史记录后:

  1. 总结 Codex 正在处理的工作。
  2. 指出未完成的步骤或终端错误。
  3. 确认用户希望继续什么。
  4. 从上一个有用的状态继续。

提示

  • 会话日志可能很大,因此应提取所需内容,而不是手动读取原始 JSONL。
  • cwd 元数据有助于定位 Codex 操作的仓库。
  • 如果用户只说“从 Codex 继续”,但未提供具体信息,请先显示最近的会话。

评论

支持 Markdown