- 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.