name: codexmonitor version: 0.2.2 description: > List/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula. Reads sessions from ~/.codex/sessions by default (or via CODEX_SESSIONS_DIR / CODEX_HOME overrides). Requires the cocoanetics/tap Homebrew tap. homepage: https://github.com/Cocoanetics/CodexMonitor metadata: moltbot: emoji: "🧾" os: ["darwin"] requires: bins: ["codexmonitor"] install: - id: brew kind: brew formula: cocoanetics/tap/codexmonitor bins: ["codexmonitor"] label: "Install codexmonitor (brew)" openclaw: requires: bins: ["codexmonitor"] install: - id: brew kind: brew formula: cocoanetics/tap/codexmonitor bins: ["codexmonitor"] label: "Install codexmonitor via Homebrew"
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) orCODEX_HOME. - Sessions can be resumed/appended by id via Codex:
codex exec resume <SESSION_ID> "message".