codexmonitor 是一个用于浏览本地 OpenAI Codex 会话的命令行工具。它读取存储在 ~/.codex/sessions 目录下的会话数据,帮助用户查看由 Codex CLI 或 VS Code 扩展产生的会话记录。
用途 codexmonitor 主要用于列出、查看和实时监视本地 Codex 会话。会话文件按日期组织在 ~/.codex/sessions/YYYY/MM/DD/ 路径下,工具会从该位置读取数据。
主要能力
- 按日期列出会话:codexmonitor list 2026/01/08
- 以 JSON 格式列出会话:codexmonitor list --json 2026/01/08
- 查看指定会话:codexmonitor show <session-id>
- 查看会话的指定消息范围:codexmonitor show <session-id> --ranges 1...3,26...28
- 以 JSON 格式查看会话:codexmonitor show <session-id> --json
- 实时监视所有会话:codexmonitor watch
- 实时监视指定会话:codexmonitor watch --session <session-id>
使用方式 通过 Homebrew 安装: brew tap cocoanetics/tap brew install codexmonitor
安装后即可使用上述命令。会话可以通过 Codex 按 ID 恢复或追加:codex exec resume <SESSION_ID> "message"。
适用场景 适用于需要检查、回顾或调试本地 Codex 会话记录的用户,尤其是同时使用 Codex CLI 和 VS Code 扩展并希望集中查看会话历史的开发者。JSON 输出便于与其他工具或脚本集成。
限制
- 目前仅支持 macOS。
- 需要已安装 Codex 并已产生会话记录(CLI 和/或 VS Code 扩展)。
- 工具依赖 ~/.codex/sessions 目录结构。
- 其他平台支持情况暂未提供。