核心功能
CodexMonitor 是一款专为 OpenAI Codex 设计的本地会话管理工具,提供命令行界面来浏览、查看和实时监控存储在 ~/.codex/sessions/ 目录下的会话数据。
主要用法
会话浏览:支持按日期层级(年/月/日)列出所有会话,输出格式可选表格或 JSON,便于脚本集成。
详情查看:通过会话 ID 查看完整对话内容,支持指定范围(如 1...3,26...28)筛选特定消息片段,避免冗长输出。
实时监控:watch 命令可持续监视会话文件的追加写入,支持全量监控或单会话追踪,方便调试长时运行的 Codex 任务。
显著优点
- 原生集成:直接读取 Codex 本地存储格式,无需额外配置
- 轻量高效:Go 编写,单二进制文件,Homebrew 一键安装
- 灵活输出:同时支持人类可读格式与 JSON 结构化输出
- 范围筛选:独有的消息范围选择功能,精准定位关键对话
- 开源透明:Cocoanetics 维护,源码公开可审计
潜在局限
- 平台限制:仅支持 macOS(Darwin),Linux/Windows 用户无法使用
- 功能单一:专注只读监控,不提供会话编辑、导出或迁移功能
- 依赖 Codex:需已安装并生成会话数据的 Codex CLI 或 VS Code 扩展
- 无远程支持:仅能访问本地文件系统,不支持云端 Codex 会话
适合人群
- 高频使用 Codex CLI 的开发者
- 需要批量处理或分析会话数据的自动化工作流
- 调试复杂多轮对话的 AI 应用开发者
- 偏好终端工具、追求工作流效率的技术用户
常规风险
- 会话文件可能包含敏感代码或 API 密钥,本地存储需做好权限管理
- JSON 输出未加密,管道传输时注意泄露风险
- 工具本身只读设计,但用户通过 Codex 原生命令恢复会话时可能产生意外覆盖