codexmonitor
// List/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula.
$ git log --oneline --stat
stars:370
forks:70
updated:February 19, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namecodexmonitor
descriptionList/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula.
homepagehttps://github.com/Cocoanetics/CodexMonitor
metadata[object Object]
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
codexmonitorreads sessions from~/.codex/sessions/YYYY/MM/DD/.- Sessions can be resumed/appended by id via Codex:
codex exec resume <SESSION_ID> "message".