Checkpoint Codex Supervision
codex_checkpointRead or update a supervisor checkpoint to anchor the original goal, constraints, and acceptance criteria during long or complex tasks, preventing goal drift.
Instructions
Optional, bounded supervisor cognition memory keyed to one native Codex thread_id; the key is not a permanent task identity and does not require future work to remain on that thread. Use it to protect the original goal, constraints, and acceptance plus concise supervisor state during long or complex supervision when context dilution or goal drift makes an external anchor worthwhile. Initialization is not tied to crossing a ChatGPT window or round, starting another Codex turn, or switching native threads; initialize early when a task is already expected to be sufficiently long or complex for that protection. Do not use for one-shot work, and do not turn duration into a hard threshold: elapsed time, observe/poll count, token count, or mere silence are not automatic triggers. Later updates remain semantic-event driven and require a material change in understanding or root cause, constraint or scope interpretation, steering decision, user-authorized amendment or effective goal, or acceptance judgment or an explicit decision not to accept yet. Before final acceptance of a checkpointed task, read it once to re-anchor the original goal, constraints, acceptance, and current supervisor frame. This tool is optional and uncoupled from all other tools. Store concise supervisor summaries only; never prompts, transcripts, raw events, command output, final answers, or raw event streams. Updates preserve only immutable original plus bounded previous/current supervisor state.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Read the checkpoint, or initialize/update it at a material supervisor decision point. | |
| next_step | No | Single next supervision step. | |
| thread_id | Yes | Native Codex thread id; no second task identifier is created. | |
| original_goal | No | Concise original user goal. Required only on initialization and immutable thereafter. | |
| effective_goal | No | Current effective goal after legitimate user amendments; defaults to original_goal on initialization. | |
| current_decision | No | Current supervisor decision and why it matters. | |
| acceptance_status | No | Concise acceptance assessment, not a task lifecycle or job status. | |
| current_amendment | No | Latest concise user-authorized requirement amendment, or null to clear it, without changing the immutable original. | |
| original_acceptance | No | Concise original acceptance criteria. Required only on initialization and immutable thereafter. | |
| original_constraints | No | Concise original constraints. Required only on initialization and immutable thereafter. | |
| current_understanding | No | Current concise root-cause or task understanding. |