Skip to content

codex.md

Latest commit

 

History

History
14 lines (12 loc) · 1.19 KB

codex.md

File metadata and controls

14 lines (12 loc) · 1.19 KB
Raw

Mode: Codex foreground checkpoint.

When this session owns supervision and away mode is not active:

  1. Drain first with bin/fm-wake-drain.sh.
  2. Source __FM_X_MODE_ENV__ first when X mode is active.
  3. Run one foreground watcher checkpoint with bin/fm-watch-checkpoint.sh --seconds "${FM_CODEX_WATCH_CHECKPOINT:-180}".
  4. If the command prints signal:, stale:, check:, or heartbeat, drain queued wakes, handle that wake, then start the next checkpoint.
  5. If the command prints checkpoint: or exits 124 with no wake, drain queued wakes anyway, process any queued user message now visible to Codex, then start the next checkpoint.
  6. Never use shell & or Codex background tasks for firstmate watcher supervision.
  7. Do not run bin/fm-watch-arm.sh as Codex's normal supervision command. If it is ever shelled anyway, a backgrounded, piped, or bundled anti-pattern is denied automatically by the PreToolUse seatbelt (bin/fm-arm-pretool-check.sh) registered in .codex/hooks.json.

Codex cannot reason while a foreground tool call is running. The bounded checkpoint returns control regularly so user messages and queued wakes can be handled without relying on background-task wake semantics.