How do I install the Codex Monitor skill?

Run npx skillmds@latest add modbender/codex-monitor in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Codex Monitor skill do?

Browse OpenAI Codex session logs stored in ~/.codex/sessions. Provides list/show/watch helpers via the local Swift project at ~/Developer/CodexMonitor. It is listed under Coding & Dev Tools on SkillMD.

Is Codex Monitor safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Codex Monitor?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Codex Monitor free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Codex Monitor?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Codex Monitor by modbender — Agent Skill

Name: Codex Monitor
Rating: 4.2 (5 reviews)
Author: modbender

File contents

codex-monitor

Use this skill to query Codex sessions on Oliver’s machine.

How it works

This skill runs the Swift executables from the local project:

~/Developer/CodexMonitor
CLI: swift run CodexMonitor-CLI ...
App: swift run CodexMonitor-App

Commands

List sessions

Day (text): python3 skills/codex-monitor/codex_monitor.py list 2026/01/08
Day (JSON): python3 skills/codex-monitor/codex_monitor.py list --json 2026/01/08
Month: python3 skills/codex-monitor/codex_monitor.py list 2026/01
Year: python3 skills/codex-monitor/codex_monitor.py list 2026

Show a session (text)

python3 skills/codex-monitor/codex_monitor.py show <session-id>
With ranges: python3 skills/codex-monitor/codex_monitor.py show <session-id> --ranges 1...3,26...28
- Open-ended: --ranges 5... (from #5 to end), --ranges ...10 (from start through #10)

Show a session (JSON)

python3 skills/codex-monitor/codex_monitor.py show <session-id> --json

Watch for changes

All sessions: python3 skills/codex-monitor/codex_monitor.py watch
Specific session: python3 skills/codex-monitor/codex_monitor.py watch --session <session-id>

Monitor (Menu Bar App)

Launch the menu bar monitor: python3 skills/codex-monitor/codex_monitor.py monitor

Notes

The underlying CLI may evolve; this wrapper passes through extra args.
If the Swift build is slow, consider building once (swift build) and then running the built binary.

Frequently asked questions

Codex Monitor