codex-monitor

name	codex-monitor
description	Monitor active Codex CLI sessions - shows status, working directory, and last messages
user_invocable	true

Codex Session Monitor

When the user invokes this skill (e.g., "/sessions"), run the session monitoring script and report the results.

What This Skill Does

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

• Thread ID and working directory for each session
• Session status: WORKING, WAITING, or IDLE
• 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

How to Run

Execute the Python script:

python3 {{skill_dir}}/scripts/sessions.py

Report the full output to the user in a code block.

Interpreting Results

• WORKING: Session has recent reasoning or function_call events - actively processing
• WAITING: Session has an input_wait event - blocked waiting for user input
• IDLE: No recent activity indicators - may be finished or stalled

Sessions are considered "active" if modified within the last 5 minutes.