核心用法
codexmonitor 是一款专为 macOS 设计的 OpenAI Codex 本地会话管理 CLI 工具，通过 Homebrew 分发。核心功能包括：
- 会话浏览：按日期列出历史会话（如
codexmonitor list 2026/01/08），支持 JSON 输出便于脚本化处理 - 会话详情：查看指定会话内容，支持范围筛选（
--ranges 1...3,26...28）和 JSON 导出 - 实时监控：
watch模式可监听全部或指定会话的新增内容
会话默认存储于 ~/.codex/sessions/YYYY/MM/DD/，可通过 CODEX_SESSIONS_DIR 或 CODEX_HOME 环境变量自定义路径。工具同时支持 Codex 原生命令恢复会话：codex exec resume <SESSION_ID> "message"。
显著优点
1. 本地化优先：数据完全留存本地，无需云端同步
2. 格式兼容：原生支持 Codex CLI 和 VS Code 扩展生成的会话文件
3. 灵活集成：JSON 输出便于与日志分析、自动化工作流结合
潜在局限
- 平台限制：仅支持 macOS（
darwin），无 Linux/Windows 支持 - 第三方分发：通过个人维护的 Homebrew tap（
cocoanetics/tap）安装，非官方 OpenAI 工具 - 功能边界：纯只读/监控工具，无法编辑或删除会话，需配合 Codex 原生命令操作
适合人群
- 高频使用 OpenAI Codex CLI 的开发者
- 需要审计或归档 AI 交互记录的技术团队
- 偏好本地数据管控的隐私敏感用户
常规风险
| 风险项 | 说明 |
|--------|------|
| 数据泄露 | 会话文件含完整对话内容，需确保 `~/.codex/` 目录权限正确（建议 `chmod 700`）|
| 供应链安全 | Homebrew tap 为第三方维护，建议审查公式源码后再安装 |
| 误操作风险 | `watch` 模式持续读取文件，大会话目录可能导致 I/O 负载 |