config.example.toml

# Required:
# Must include {prompt_file}; may include {workspace}.
agent_command_template = "scripts/invoke-codex-agent.sh {prompt_file} {workspace}"

# 0 means unbounded loop until stop condition.
max_iterations = 0

# Stop when reviewer keeps giving same next_focus for this many rounds.
max_stagnation = 4

# Per command timeout.
command_timeout_sec = 1200

# Create this file under state-dir to stop loop.
stop_file_name = "STOP"

# Create this file under workspace to stop loop.
global_stop_file_name = ".codex-stop"

# Prompt hint only.
planner_model_hint = "balanced"
reviewer_model_hint = "strict"

# Number of history rows fed back to planner each round.
history_tail = 8

# Gate tight restart loops when no new git changes are produced.
no_change_gate = true

# Exponential backoff controls for transient errors.
backoff_base_sec = 5
backoff_max_sec = 300

# Backoff controls for low-signal outcomes.
no_change_backoff_sec = 60
continue_false_backoff_sec = 300
planner_stop_backoff_sec = 600

# Single-instance lock under state-dir.
lock_file_name = "loop.lock"

# If this token appears in agent output, the loop treats task as complete.
completion_promise = "DONE"