Codexmonitor

List/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula. Reads sessions from ~/.codex/sessions by default (or...

Oliver Drobnik

@odrobnik

What This Skill Does

CLI and VS Code tool to list, inspect, and watch local OpenAI Codex sessions stored under ~/.codex/sessions. Supports filtering by date, viewing session details with optional line ranges, and live monitoring of session activity.

Replaces manually navigating Codex session files on disk by providing a structured CLI and VS Code integration for browsing and monitoring sessions.

When to Use It

  • List all Codex sessions created on a specific date
  • Inspect the full content of a particular Codex session by ID
  • View specific line ranges within a Codex session
  • Watch for new or updated Codex sessions in real time
  • Export session data as JSON for further processing or analysis
  • Resume a previous Codex session by retrieving its session ID

Install

$ openclaw skills install @odrobnik/codexmonitor

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 <session-id>
  • Show with ranges: codexmonitor show <session-id> --ranges 1...3,26...28
  • Show JSON: codexmonitor show <session-id> --json
  • Watch all: codexmonitor watch
  • Watch specific: codexmonitor watch --session <session-id>

Notes

  • Sessions live under ~/.codex/sessions/YYYY/MM/DD/ by default.
  • If your sessions live somewhere else, set CODEX_SESSIONS_DIR (preferred) or CODEX_HOME.
  • Sessions can be resumed/appended by id via Codex: codex exec resume <SESSION_ID> "message".

Top skills in this category