codex-monitor

name	codex-monitor
description	Browse 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.