codexmonitor
List/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula.
When & Why to Use This Skill
CodexMonitor is a specialized developer tool designed to enhance the observability of local OpenAI Codex sessions. It allows developers to list, inspect, and monitor AI-driven coding interactions across CLI and VS Code environments. By providing a structured way to access session history stored locally, it bridges the gap between AI generation and developer oversight, ensuring better transparency and control over AI-assisted workflows.
Use Cases
- Session Debugging: Review historical OpenAI Codex sessions to trace how specific code suggestions were generated and identify the context behind AI-driven changes.
- Real-time Monitoring: Use the 'watch' command to observe active AI coding sessions as they happen, allowing for immediate quality checks during the development process.
- Context Retrieval: Quickly locate past prompts and code snippets by filtering sessions by date or ID, making it easy to reuse successful AI interactions.
- Audit & Compliance: Export local session data to JSON format for auditing AI usage or integrating interaction logs into external developer productivity dashboards.
- Workflow Optimization: Analyze session ranges and specific command outputs to refine prompt engineering strategies and improve the efficiency of local AI tools.
| name | codexmonitor |
|---|---|
| description | List/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula. |
| homepage | https://github.com/Cocoanetics/CodexMonitor |
| metadata | {"clawdbot":{"emoji":"🧾","os":["darwin"],"requires":{"bins":["codexmonitor"]},"install":[{"id":"brew","kind":"brew","formula":"cocoanetics/tap/codexmonitor","bins":["codexmonitor"],"label":"Install codexmonitor (brew)"}]}} |
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".