codexmonitor

List/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula.

⭐3stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️2downloads

When & Why to Use This Skill

CodexMonitor is a specialized developer tool designed to enhance the observability of local OpenAI Codex sessions. It allows developers to list, inspect, and monitor AI-driven coding interactions across CLI and VS Code environments. By providing a structured way to access session history stored locally, it bridges the gap between AI generation and developer oversight, ensuring better transparency and control over AI-assisted workflows.

Use Cases

  • Session Debugging: Review historical OpenAI Codex sessions to trace how specific code suggestions were generated and identify the context behind AI-driven changes.
  • Real-time Monitoring: Use the 'watch' command to observe active AI coding sessions as they happen, allowing for immediate quality checks during the development process.
  • Context Retrieval: Quickly locate past prompts and code snippets by filtering sessions by date or ID, making it easy to reuse successful AI interactions.
  • Audit & Compliance: Export local session data to JSON format for auditing AI usage or integrating interaction logs into external developer productivity dashboards.
  • Workflow Optimization: Analyze session ranges and specific command outputs to refine prompt engineering strategies and improve the efficiency of local AI tools.
namecodexmonitor
descriptionList/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula.
homepagehttps://github.com/Cocoanetics/CodexMonitor
metadata{"clawdbot":{"emoji":"🧾","os":["darwin"],"requires":{"bins":["codexmonitor"]},"install":[{"id":"brew","kind":"brew","formula":"cocoanetics/tap/codexmonitor","bins":["codexmonitor"],"label":"Install codexmonitor (brew)"}]}}

codexmonitor

Use codexmonitor to browse local OpenAI Codex sessions stored in ~/.codex/sessions.

Requirements

  • macOS
  • Codex installed and producing sessions (CLI and/or VS Code extension)

Install (Homebrew)

brew tap cocoanetics/tap
brew install codexmonitor

Common commands

  • List sessions (day): codexmonitor list 2026/01/08
  • List sessions (day, JSON): codexmonitor list --json 2026/01/08
  • Show a session: codexmonitor show <session-id>
  • Show with ranges: codexmonitor show <session-id> --ranges 1...3,26...28
  • Show JSON: codexmonitor show <session-id> --json
  • Watch all: codexmonitor watch
  • Watch specific: codexmonitor watch --session <session-id>

Notes

  • codexmonitor reads sessions from ~/.codex/sessions/YYYY/MM/DD/.
  • Sessions can be resumed/appended by id via Codex: codex exec resume <SESSION_ID> "message".