codex_monitor_skill

A custom skill for monitoring active Codex CLI sessions.

What it does

Monitors all active Codex CLI sessions by parsing JSONL rollout files in ~/.codex/sessions/. Shows:

• Thread ID and working directory for each session
• Session status: 🔄 WORKING, ⏸️ WAITING, or 💤 IDLE
• Log file size (indicates session length/activity)
• Last modification time
• Last 2-3 lines of the most recent user message
• Last 2-3 lines of the most recent Codex response

Installation

make install

This installs the skill to ~/.clawdbot/skills/codex-monitor/.

Usage

In any Codex CLI session, type:

/codex-monitor

Standalone usage

You can also run the script directly:

# One-time view
python3 scripts/sessions.py

# Watch mode (refreshes every 5s)
python3 scripts/sessions.py -w

# Custom refresh interval
python3 scripts/sessions.py -w -n 2

Uninstall

make uninstall