OpenClaw logo
OpenClaw Skills
skills$openclaw/codex-monitor
odrobnik3.4k★

by odrobnik

codex-monitor – OpenClaw Skill

codex-monitor is an OpenClaw Skills integration for coding workflows. Browse OpenAI Codex session logs stored in ~/.codex/sessions. Provides list/show/watch helpers via the local Swift project at ~/Developer/CodexMonitor.

3.4k stars1.5k forksSecurity L1
Updated Feb 7, 2026Created Feb 7, 2026coding

Skill Snapshot

namecodex-monitor
descriptionBrowse OpenAI Codex session logs stored in ~/.codex/sessions. Provides list/show/watch helpers via the local Swift project at ~/Developer/CodexMonitor. OpenClaw Skills integration.
ownerodrobnik
repositoryodrobnik/codex-monitor
languageMarkdown
licenseMIT
topics
securityL1
installopenclaw add @odrobnik/codex-monitor
last updatedFeb 7, 2026

Maintainer

odrobnik

odrobnik

Maintains codex-monitor in the OpenClaw Skills directory.

View GitHub profile
File Explorer
3 files
.
_meta.json
280 B
codex_monitor.py
1.1 KB
SKILL.md
1.6 KB
SKILL.md

name: codex-monitor description: Browse OpenAI Codex session logs stored in ~/.codex/sessions. Provides list/show/watch helpers via the local Swift project at ~/Developer/CodexMonitor.

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.
README.md

No README available.

Permissions & Security

Security level L1: Low-risk skills with minimal permissions. Review inputs and outputs before running in production.

Requirements

  • OpenClaw CLI installed and configured.
  • Language: Markdown
  • License: MIT
  • Topics:

FAQ

How do I install codex-monitor?

Run openclaw add @odrobnik/codex-monitor in your terminal. This installs codex-monitor into your OpenClaw Skills catalog.

Does this skill run locally or in the cloud?

OpenClaw Skills execute locally by default. Review the SKILL.md and permissions before running any skill.

Where can I verify the source code?

The source repository is available at https://github.com/openclaw/skills/tree/main/skills/odrobnik/codex-monitor. Review commits and README documentation before installing.