Codexmonitor

🧾 本地 Codex 会话监控与管理工具

本地 Codex 会话管理工具,支持列出、查看、实时监控 OpenAI Codex 历史记录,适合 macOS 开发者回溯 AI 交互。

收藏
15k
安装
3.7k
版本
0.2.0
CLS 安全性认证2026-06-05
点击查看完整报告 >

使用说明

核心用法

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_DIRCODEX_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 负载 |

安全解读

核心用法

codexmonitor 是一款由 Cocoanetics 开发的命令行工具,用于浏览、监控和管理本地 OpenAI Codex CLI 会话。该 Skill 为纯文档型技能,仅提供该工具的使用说明,不包含任何可执行代码。

主要功能包括:

  • 会话列表查询:按日期列出会话 codexmonitor list YYYY/MM/DD
  • 会话详情查看:展示特定会话的完整内容 codexmonitor show <session-id>
  • 范围筛选:支持指定消息范围查看 --ranges 1...3,26...28
  • JSON 输出:所有命令均支持 --json 格式输出
  • 实时监控:支持 watch 模式持续监控会话更新
  • 环境变量配置:可通过 CODEX_SESSIONS_DIRCODEX_HOME 自定义会话目录

显著优点

1. 安全无风险:纯 Markdown 文档技能,无任何可执行代码,静态分析、动态行为、依赖审计、网络分析、隐私合规、威胁情报六维检测全部通过
2. 来源可信:由知名 iOS/macOS 开发工具组织 Cocoanetics 维护,GitHub 开源项目,T2 可信级别

3. 安装便捷:通过 Homebrew 一键安装 brew install cocoanetics/tap/codexmonitor

4. 隐私友好:不收集、处理或传输任何用户数据,符合 GDPR/CCPA 标准

5. 实用性强:Codex 会话默认存储在本地,该工具填补了官方缺乏会话浏览工具的空白

潜在局限

1. 仅支持 macOS:依赖 Homebrew 安装,目前仅限 Darwin 系统
2. 需外部工具依赖:Skill 本身不提供 codexmonitor 二进制,需用户自行安装

3. 功能范围有限:仅针对会话浏览场景,不包含会话编辑或管理功能

4. 文档更新滞后:codexmonitor 工具更新后,Skill 文档可能未及时同步

适合人群

  • 频繁使用 OpenAI Codex CLI 的开发者
  • 需要审计、复盘或分享 Codex 会话内容的用户
  • 注重数据隐私、偏好本地会话管理的用户
  • macOS 平台的技术用户

常规风险

极低风险。该 Skill 本身为纯文档,无代码执行、无网络请求、无数据收集。唯一需注意的外部风险是 codexmonitor 工具本身会读取本地 Codex 会话文件,建议:仅从官方 Homebrew 源安装,避免将包含敏感信息的会话分享给不可信第三方。

Codexmonitor 内容

手动下载zip · 1.7 kB
SETUP.mdtext/markdown
请选择文件