codexmonitor

Use codexmonitor to browse local OpenAI Codex sessions.

Setup

See SETUP.md for prerequisites and setup instructions.

Common commands

• List sessions (day): codexmonitor list 2026/01/08
• List sessions (day, JSON): codexmonitor list --json 2026/01/08
• Show a session: codexmonitor show <session-id>
• Show with ranges: codexmonitor show <session-id> --ranges 1...3,26...28
• Show JSON: codexmonitor show <session-id> --json
• Watch all: codexmonitor watch
• Watch specific: codexmonitor watch --session <session-id>

Notes

• Sessions live under ~/.codex/sessions/YYYY/MM/DD/ by default.
• If your sessions live somewhere else, set CODEX_SESSIONS_DIR (preferred) or CODEX_HOME.
• Sessions can be resumed/appended by id via Codex: codex exec resume <SESSION_ID> "message".