CodexMonitor is a specialized CLI tool for listing, inspecting, and watching local OpenAI Codex sessions on macOS.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install codexmonitor
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install codexmonitor using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is CodexMonitor?
CodexMonitor is a powerful utility designed for developers utilizing OpenAI Codex through CLI or VS Code environments. It enables users to browse local session logs, providing a transparent view into the interactions and history of AI coding tasks. By integrating this tool into your Openclaw Skills library, you can effectively audit and monitor the behavior of your AI agents, ensuring better control over local session data and code generation history.
CodexMonitor Use Cases
- Debugging and auditing local OpenAI Codex sessions by inspecting specific interaction ranges.
- Monitoring active AI coding workflows in real-time using the watch command.
- Organizing and retrieving historical session data based on specific dates or session IDs.
- Exporting session logs to JSON format for data analysis or integration with other Openclaw Skills.
How CodexMonitor Works
- Scans the local filesystem for session data, typically stored within the ~/.codex/sessions directory.
- Indexes sessions based on a temporal directory structure (YYYY/MM/DD) for easy navigation.
- Provides a command-line interface to filter, view, and live-stream session updates.
- Optionally utilizes environment variables like CODEX_SESSIONS_DIR to point to custom storage locations.
CodexMonitor Setup
To get started with this component of your Openclaw Skills, install the binary via Homebrew on macOS:
# Tap the repository
brew tap cocoanetics/tap
# Install codexmonitor
brew install codexmonitor
Ensure that your OpenAI Codex sessions are being saved to the default path (~/.codex/sessions) or set the CODEX_SESSIONS_DIR environment variable.
CodexMonitor Data Schema & Taxonomy
CodexMonitor organizes session data based on a predictable filesystem hierarchy. Below is the metadata and storage schema:
| Attribute | Description |
|---|---|
| Default Path | ~/.codex/sessions/YYYY/MM/DD/ |
| Env Overrides | CODEX_SESSIONS_DIR or CODEX_HOME |
| Session ID | Unique identifier for specific AI interaction sequences |
| Output Formats | Plain text (standard) or JSON (via --json flag) |
CodexMonitor Advanced Features
- Real-time session monitoring across all active sessions using the watch command.
- Granular inspection of specific line ranges within a session log for precise debugging.
- Seamless integration with VS Code sessions, allowing for CLI-based oversight of IDE activities.
- Full JSON support for developers building automation around their Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Codex Monitor
A dual Python and Swift-based utility for browsing, watching, and managing local OpenAI Codex session logs.
Announcer
House-wide text-to-speech announcements using AirPlay speakers, Airfoil, and ElevenLabs.
Social Research (Ravens)
A tiered social intelligence tool that gathers X/Twitter insights through API access, web search, and browser scraping.
Knowledge Base (RAG) — Your Second Brain
A sophisticated Retrieval-Augmented Generation (RAG) system that uses SQLite and vector embeddings to give your AI agent a persistent, semantic memory.
Printer Skill
Enables AI agents to print images and PDFs to any CUPS printer with full PPD-aware configuration support.
ElevenLabs
A versatile toolkit for programmatic AI audio generation, voice management, and usage tracking.
METADATA
Featured*
