codex-monitor

Browse OpenAI Codex session logs stored in ~/.codex/sessions. Provides list/show/watch helpers via the local Swift project at ~/Developer/CodexMonitor.

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

When & Why to Use This Skill

The codex-monitor skill is a specialized developer tool designed to browse, track, and analyze OpenAI Codex session logs stored locally. By providing comprehensive commands to list, display, and watch session activities in real-time, it enables developers to gain deep insights into AI interactions, debug generated code history, and maintain a transparent record of automated programming tasks.

Use Cases

  • Session Auditing: Quickly list and retrieve historical Codex sessions by date to review previous AI-assisted coding decisions and logic.
  • Real-time Debugging: Use the 'watch' command to monitor live Codex outputs and session changes as they happen during the development workflow.
  • Data Extraction: Export specific session logs or code ranges into JSON format for further analysis, documentation, or integration with other developer tools.
  • Workflow Monitoring: Utilize the dedicated menu bar application to keep a constant eye on AI agent activity without interrupting the primary coding environment.
namecodex-monitor
descriptionBrowse OpenAI Codex session logs stored in ~/.codex/sessions. Provides list/show/watch helpers via the local Swift project at ~/Developer/CodexMonitor.

codex-monitor

Use this skill to query Codex sessions on Oliver’s machine.

How it works

This skill runs the Swift executables from the local project:

  • ~/Developer/CodexMonitor
  • CLI: swift run CodexMonitor-CLI ...
  • App: swift run CodexMonitor-App

Commands

List sessions

  • Day (text): python3 skills/codex-monitor/codex_monitor.py list 2026/01/08
  • Day (JSON): python3 skills/codex-monitor/codex_monitor.py list --json 2026/01/08
  • Month: python3 skills/codex-monitor/codex_monitor.py list 2026/01
  • Year: python3 skills/codex-monitor/codex_monitor.py list 2026

Show a session (text)

  • python3 skills/codex-monitor/codex_monitor.py show <session-id>
  • With ranges: python3 skills/codex-monitor/codex_monitor.py show <session-id> --ranges 1...3,26...28
    • Open-ended: --ranges 5... (from #5 to end), --ranges ...10 (from start through #10)

Show a session (JSON)

  • python3 skills/codex-monitor/codex_monitor.py show <session-id> --json

Watch for changes

  • All sessions: python3 skills/codex-monitor/codex_monitor.py watch
  • Specific session: python3 skills/codex-monitor/codex_monitor.py watch --session <session-id>

Monitor (Menu Bar App)

  • Launch the menu bar monitor: python3 skills/codex-monitor/codex_monitor.py monitor

Notes

  • The underlying CLI may evolve; this wrapper passes through extra args.
  • If the Swift build is slow, consider building once (swift build) and then running the built binary.