---
name: sundial-org-codexmonitor
description: "List/inspect/watch local OpenAI Codex sessions (CLI + VS Code) using the CodexMonitor Homebrew formula."
metadata:
  decimalai-skill-id: "05d1e0ed-b868-49ac-b1c3-f1434d7effbb"
  decimalai-version-id: "2f543e84-7067-4e64-9264-b9e28a06cb74"
  decimalai-version: "1"
  decimalai-body-sha256: "f6c76740e46486a9020fa63f28ce7c14e05d9174cd8cf152591ecd1adbb23d73"
  decimalai-name: "sundial-org/codexmonitor"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "agent-tooling"
  decimalai-source: "https://app.decimal.ai/s/sundial-org-codexmonitor@1/SKILL.md"
---
# codexmonitor

Use `codexmonitor` to browse local OpenAI Codex sessions stored in `~/.codex/sessions`.

## Requirements
- macOS
- Codex installed and producing sessions (CLI and/or VS Code extension)

## Install (Homebrew)

```sh
brew tap cocoanetics/tap
brew install codexmonitor
```

## 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
- `codexmonitor` reads sessions from `~/.codex/sessions/YYYY/MM/DD/`.
- Sessions can be resumed/appended by id via Codex: `codex exec resume <SESSION_ID> "message"`.