codex-monitor
Browse OpenAI Codex session logs stored in ~/.codex/sessions. Provides list/show/watch helpers via the local Swift project at ~/Developer/CodexMonitor.
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.
| 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)
- Open-ended:
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.