← Back to Skills Marketplace
Codexmonitor
by
Oliver Drobnik
· GitHub ↗
· v0.2.2
3658
Downloads
6
Stars
11
Active Installs
7
Versions
Install in OpenClaw
/install codexmonitor
Description
List/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula. Reads sessions from ~/.codex/sessions by default (or...
README (SKILL.md)
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 \x3Csession-id> - Show with ranges:
codexmonitor show \x3Csession-id> --ranges 1...3,26...28 - Show JSON:
codexmonitor show \x3Csession-id> --json - Watch all:
codexmonitor watch - Watch specific:
codexmonitor watch --session \x3Csession-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 \x3CSESSION_ID> "message".
Usage Guidance
This skill appears coherent with its purpose, but take these precautions before installing: (1) Verify the Homebrew tap and formula (cocoanetics/tap) and review the GitHub repo to ensure the binary is trustworthy. Third‑party taps can install arbitrary code. (2) Be aware codexmonitor reads your local Codex session files (~/.codex/sessions), which may contain sensitive prompts or data — only install if you trust the binary. (3) Consider inspecting the installed binary or running it in a restricted environment (sandbox, VM) and monitor network activity the first time you run it. (4) If you need stronger assurance, ask for the formula/source of the codexmonitor binary and have it reviewed before installing.
Capability Analysis
Type: OpenClaw Skill
Name: codexmonitor
Version: 0.2.2
The skill bundle is designed to install and use `codexmonitor` via Homebrew to inspect local OpenAI Codex sessions. All instructions in `SKILL.md` and `SETUP.md` are straightforward, focusing on installation and usage of the `codexmonitor` tool. There is no evidence of prompt injection against the agent, data exfiltration, malicious execution, persistence mechanisms, or obfuscation. The access to `~/.codex/sessions/` is explicitly stated and directly aligns with the skill's stated purpose of monitoring Codex sessions.
Capability Assessment
Purpose & Capability
Name/description (list/inspect/watch local Codex sessions) match the declared requirements: a codexmonitor binary installed via the cocoanetics/tap Homebrew formula. No unrelated binaries or credentials are requested.
Instruction Scope
SKILL.md instructs the agent to run the codexmonitor binary and to read session files under ~/.codex/sessions (or CODEX_SESSIONS_DIR / CODEX_HOME). Accessing these local session files is sensitive but is directly relevant to the tool's purpose.
Install Mechanism
Installation uses a Homebrew formula from a third-party tap (cocoanetics/tap). Homebrew installs a binary to disk which will be executed; this is expected but higher-risk than an official/mainstream tap — verify the tap/formula before installing.
Credentials
No required environment variables or credentials are declared. Optional env vars mentioned (CODEX_SESSIONS_DIR, CODEX_HOME) are appropriate for overriding the sessions path.
Persistence & Privilege
Skill is not always-enabled and does not request elevated platform privileges. It does not declare modifications to other skills or global agent configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install codexmonitor - After installation, invoke the skill by name or use
/codexmonitor - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.2
fix: use /Users/oliver/clawd for workspace root to preserve symlink paths
v0.2.1
Rename .clawdhubignore to .clawhubignore
v0.2.0
Refactor: move setup/prerequisites to SETUP.md, keep SKILL.md lean
v0.1.3
Docs: sessions dir overrides (CODEX_SESSIONS_DIR/CODEX_HOME); clarify non-hardcoded default path.
v0.1.2
Clarify ~/.codex/sessions access + add README and OpenClaw metadata.
v0.1.1
- Added version field (0.1.1) and expanded metadata in SKILL.md.
- Improved description to clarify requirements and Homebrew tap dependency.
- Updated metadata to include separate configurations for moltbot and openclaw.
- Added README.md file.
v0.1.0
Switch skill to Homebrew-based codexmonitor CLI (no wrapper)
Metadata
Frequently Asked Questions
What is Codexmonitor?
List/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula. Reads sessions from ~/.codex/sessions by default (or... It is an AI Agent Skill for Claude Code / OpenClaw, with 3658 downloads so far.
How do I install Codexmonitor?
Run "/install codexmonitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Codexmonitor free?
Yes, Codexmonitor is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Codexmonitor support?
Codexmonitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Codexmonitor?
It is built and maintained by Oliver Drobnik (@odrobnik); the current version is v0.2.2.
More Skills