codexmonitor

codexmonitor

Use codexmonitor to browse local OpenAI Codex sessions stored in ~/.codex/sessions.

Requirements

• macOS
• Codex installed and producing sessions (CLI and/or VS Code extension)

Install (Homebrew)

brew tap cocoanetics/tap
brew install codexmonitor

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

• codexmonitor reads sessions from ~/.codex/sessions/YYYY/MM/DD/.
• Sessions can be resumed/appended by id via Codex: codex exec resume <SESSION_ID> "message".