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.