CodexMonitor

Homebrew-installed helper to list, inspect, and watch local OpenAI Codex sessions. Available as CLI and VS Code extension.

CodexMonitor by @odrobnik is a developer tool that lets you list, inspect, and watch local OpenAI Codex sessions from the command line or VS Code. When you're running Codex agents — especially multiple concurrent sessions through OpenClaw's ACP integration — it's easy to lose track of what each session is doing. CodexMonitor reads from `~/.codex/sessions` and gives you a live dashboard of all active and completed sessions with their status, output, and history. The tool is distributed via Homebrew (`brew install codexmonitor`) and also available as a VS Code extension, making it accessible from whichever environment you prefer. The CLI version is particularly useful for OpenClaw users who spawn Codex sessions as sub-agents — you can quickly check session status, read execution logs, and inspect what code changes were made without leaving your terminal. CodexMonitor also has an OpenClaw skill on ClawHub, which means your OpenClaw agent itself can use it to monitor and report on running Codex sessions. This creates a powerful meta-workflow: ask your agent in Telegram to check what your Codex sessions are doing, and get a formatted summary back. It's the kind of observability tool that becomes essential once you're running multi-agent setups.

Tags: devtools, codex, brew, monitoring

Category: devtools

Tips

  • Install via `brew install codexmonitor` for automatic updates and clean dependency management
  • Use the watch mode (`codexmonitor watch`) to get live updates when sessions start, complete, or fail
  • Install the OpenClaw skill from ClawHub so your agent can query Codex session status on your behalf
  • Pair with OpenClaw's sub-agent spawning to create a 'check on my Codex workers' command accessible from Telegram
  • The VS Code extension shows session status in your editor sidebar — useful when you're coding alongside agent sessions

Community Feedback

List/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula. Essential for anyone running multiple Codex agents.

— ClawHub

CodexMonitor: Monitor Codex activity. Available as a Homebrew cask with automatic updates.

— Homebrew Formulae

Frequently Asked Questions

Do I need OpenClaw to use CodexMonitor?

No. CodexMonitor works standalone as a CLI tool or VS Code extension for anyone using OpenAI Codex. The OpenClaw skill is an optional add-on that lets your agent query session status.

Where does CodexMonitor read session data from?

It reads from `~/.codex/sessions` by default, which is where OpenAI Codex stores local session data. You can configure a custom path if your sessions are stored elsewhere.

Can it monitor remote Codex sessions?

CodexMonitor is designed for local sessions. For remote monitoring, you'd need to sync the session directory or use a different approach like SSH tunneling.

Is it available on Linux?

The Homebrew formula is primarily for macOS. Check the GitHub repo for Linux installation instructions — the underlying tool may work on Linux with manual installation.