核心功能
codexmonitor 是一款专为 OpenAI Codex 设计的本地会话管理工具，通过读取 ~/.codex/sessions 目录下的会话数据，提供列出、查看详情、实时监控三大核心能力。
主要用法
| 场景 | 命令 |
|------|------|
| 按日期列出会话 | `codexmonitor list 2026/01/08` |
| 结构化输出 | `codexmonitor list --json 2026/01/08` |
| 查看完整会话 | `codexmonitor show <session-id>` |
| 指定消息范围 | `codexmonitor show <id> --ranges 1...3,26...28` |
| 实时监控所有会话 | `codexmonitor watch` |
| 监控指定会话 | `codexmonitor watch --session <id>` |
显著优点
1. 原生集成 Codex 生态：直接读取 Codex CLI 和 VS Code 扩展生成的会话文件，无需额外配置
2. 灵活的目录覆盖：支持 CODEX_SESSIONS_DIR 和 CODEX_HOME 环境变量自定义路径
3. 多格式输出：JSON 模式便于与下游工具（如日志分析、BI）集成
4. 实时 watch 模式：适合开发调试时监控会话变化
5. 轻量无依赖：单一二进制，Homebrew 一键安装
局限性与风险
| 方面 | 说明 |
|------|------|
| **平台限制** | 仅支持 macOS（`darwin`），无 Linux/Windows 版本 |
| **数据源依赖** | 需 Codex 已生成会话文件；若 Codex 未运行则无数据 |
| **第三方 Tap** | 依赖 `cocoanetics/tap` 非官方 Homebrew core，更新时效取决于维护者 |
| **权限问题** | 需读取 `~/.codex/sessions` 目录，多用户场景需注意权限配置 |
| **无远程功能** | 纯本地工具，不涉及云端 Codex 会话同步 |
适合人群
- macOS 开发者：日常使用 Codex CLI 或 VS Code 扩展
- 会话审计需求：需要追溯、分析历史对话内容
- 自动化工作流：通过 JSON 输出对接日志系统或 CI/CD 管道
安全提示
- 会话文件可能包含代码片段和提示词，注意目录权限设置（建议
chmod 700 ~/.codex） - JSON 导出时避免将敏感会话内容提交至公共仓库